Tag ed etichette

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa pagina descrive i tag e le etichette che puoi impostare nelle risorse Cloud Storage.

Panoramica

I tag e le etichette di bucket di Google Cloud Storage sono due modi per organizzare le risorse di Cloud Storage.

I tag e le etichette funzionano indipendentemente l'uno dall'altro e puoi utilizzarli entrambi nello stesso bucket.

Tag

I tag sono coppie chiave-valore che puoi applicare alle tue risorse per un controllo granulare degli accessi.

I tag vengono creati a livello di organizzazione e gestiti tramite Resource Manager, che viene utilizzato in Google Cloud. Dopo aver collegato un tag a un bucket Cloud Storage, puoi utilizzare il tag con condizioni IAM per concedere l'accesso alle risorse Cloud Storage o con i criteri dell'organizzazione per applicare i vincoli alle risorse Cloud Storage.

Sebbene i tag siano gestiti tramite Resource Manager, devi disporre delle seguenti autorizzazioni IAM di Cloud Storage per visualizzare e impostare i tag nei bucket Cloud Storage:

  • storage.buckets.listTagBindings
  • storage.buckets.createTagBinding
  • storage.buckets.deleteTagBinding

Queste autorizzazioni possono essere ereditate tramite ruoli IAM come resourcemanager.tagUser e storage.admin.

Per l'anteprima, tieni presente le seguenti limitazioni:

  • I tag possono essere associati a un bucket solo dopo che è stato creato.

  • I tag non sono supportati per i bucket situati nelle aree geografiche us-east2, us-east3 e us-south1.

  • I tag vengono ignorati dal vincolo di limitazione al dominio. Ad esempio, supponiamo che utilizzi il vincolo per specificare che solo gli utenti di exampledomain.com possono essere aggiunti al criterio IAM di un bucket se al tag è associato un tag. Tuttavia, anche quando un tag è associato al bucket, gli utenti esterni a exampledomain.com possono comunque essere aggiunti al criterio IAM del bucket.

  • In rari casi, potresti riscontrare latenze elevate quando leggi o modifichi i tag associati ai bucket.

Non è possibile applicare tag agli oggetti Cloud Storage.

Esempi per il collegamento di tag ai bucket Cloud Storage

Dopo aver creato e definito un tag, puoi associarlo al bucket Cloud Storage.

Considera il seguente scenario:

  • Il valore tag ha un nome con spazio dei nomi di 815471563813/color/blue.
  • Il bucket è denominato my-bucket.
  • Il tuo bucket si trova in us-central1.

Il seguente comando gcloud collega il tag a my-bucket:

gcloud alpha resource-manager tags bindings create \
--tag-value=815471563813/color/blue \
--parent=//storage.googleapis.com/projects/_/buckets/my-bucket
--location=us-central1

Il seguente comando gcloud scollega il tag da my-bucket:

gcloud alpha resource-manager tags bindings delete \
--tag-value=815471563813/color/blue \
--parent=//storage.googleapis.com/projects/_/buckets/my-bucket \
--location=us-central1

Il seguente comando gcloud elenca tutti i tag collegati direttamente a my-bucket, tranne i tag ereditati da my-bucket:

gcloud alpha resource-manager tags bindings list \
    --parent=//storage.googleapis.com/projects/_/buckets/my-bucket \
    --location=us-central1

Per istruzioni più dettagliate, consulta Collegamento di tag alle risorse.

Dettagli dei prezzi

I tag per i bucket Cloud Storage sono scontati al 100% fino al 15 settembre 2022. Dopo il 15 settembre 2022, i tag per i bucket Cloud Storage sono soggetti ai prezzi.

Etichette dei bucket

Le etichette dei bucket consentono di creare coppie chiave-valore arbitrarie che vengono archiviate come parte dei metadati del bucket. Puoi utilizzare le etichette per organizzare i bucket insieme ad altre risorse Google Cloud come istanze di macchine virtuali e dischi permanenti. Supponiamo, ad esempio, che tu voglia una chiave denominata team con i valori alpha, beta e delta, che utilizzerai per indicare quale team è associato a determinate risorse Google Cloud. Per ottenere questo risultato, puoi applicare le etichette team:alpha, team:beta e team:delta alle risorse desiderate.

Quando lavori con le etichette dei bucket, tieni presente quanto segue:

  • Le chiavi e i valori non possono contenere più di 63 caratteri ciascuno.
  • Le chiavi e i valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Sono consentiti caratteri internazionali.
  • Le chiavi delle etichette devono iniziare con una lettera minuscola e sono consentiti caratteri internazionali.
  • Le chiavi delle etichette non possono essere vuote.
  • A ogni bucket possono essere applicate massimo 64 etichette.
  • Come nel caso dei metadati dei bucket, le etichette dei bucket non sono associate ai singoli oggetti o ai metadati degli oggetti.

Per un esempio generale di utilizzo delle etichette per organizzare le risorse nella fatturazione, vedi Esempi di query per l'esportazione della fatturazione in BigQuery.

Dettagli dei prezzi

Le etichette dei bucket sono gratuite.

Passaggi successivi