Tag ed etichette

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

Panoramica

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

  • I tag possono essere utilizzati a livelli più elevati della gerarchia delle risorse e in Cloud de Confiance. Vengono gestiti utilizzando Resource Manager e possono essere referenziati nei binding dei criteri IAM per concedere l'accesso condizionale alle risorse.

  • Le etichette dei bucket vengono gestite utilizzando gli strumenti di Cloud Storage.

I tag e le etichette funzionano in modo indipendente l'uno dall'altro e puoi utilizzarli entrambi sullo stesso bucket.

Tag

I tag sono coppie chiave-valore che puoi applicare alle risorse per un controllo dell'accesso granulare e dati di costo granulari a livello di bucket.

I tag vengono creati a livello di organizzazione o progetto e gestiti tramite il Resource Manager, che viene utilizzato in Cloud de Confiance. Dopo aver collegato un tag a un bucket Cloud Storage, puoi utilizzarlo con le condizioni IAM per concedere l'accesso alle risorse o con i criteri dell'organizzazione per applicare vincoli alle risorse. Puoi anche utilizzare il tag per analizzare i dati di costo di utilizzo dettagliati esportati nella fatturazione Cloud.

Quando utilizzi i tag, tieni presente le seguenti limitazioni:

  • I tag possono essere collegati a un bucket solo dopo la creazione del bucket.

  • I tag non possono essere applicati agli oggetti.

  • Puoi avere un massimo di 50 binding di tag per bucket.

Autorizzazioni obbligatorie

Sebbene i tag vengano gestiti tramite Resource Manager, devi disporre delle seguenti autorizzazioni IAM per impostare e gestire i tag sui bucket:

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

Queste autorizzazioni possono essere ereditate tramite ruoli personalizzati o ruoli predefiniti, come il ruolo Tag User (roles/resourcemanager.tagUser) o il ruolo Amministratore Storage (roles/storage.admin).

Esempi di collegamento di tag ai bucket Cloud Storage

Dopo aver creato e definito un tag, puoi collegarlo al tuo bucket.

Considera il seguente scenario:

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

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

gcloud 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 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, ad eccezione dei tag ereditati da my-bucket:

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

Per istruzioni più dettagliate, consulta Collegare i tag alle risorse.

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 Cloud de Confiance by S3NS risorse come le istanze di macchine virtuali. Ad esempio, supponiamo di voler una chiave denominata team con i valori alpha, beta, e delta, che utilizzerai per indicare il team associato a determinate Cloud de Confiance risorse. Per farlo, puoi applicare le etichette team:alpha, team:beta, e team:delta alle risorse.

Tieni presente quanto segue quando utilizzi le etichette dei bucket:

  • Le chiavi e i valori non possono superare i 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 attivamente un massimo di 64 etichette.
  • Come in genere accade per i metadati dei bucket, le etichette dei bucket non sono associate a singoli oggetti o metadati degli oggetti.

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

Passaggi successivi