Organizza le risorse utilizzando le etichette

Le etichette sono coppie chiave-valore che possono essere utilizzate su Google Cloud per raggruppare risorse correlate o associate. Ad esempio, su Compute Engine puoi utilizzare le etichette per raggruppare le VM in categorie come produzione, staging o sviluppo, in modo da poter cercare le risorse che appartengono a ogni fase di sviluppo.

Dopo aver aggiunto le etichette alle risorse, puoi sfruttare la funzionalità di filtraggio nidificato per eseguire ricerche più precise delle risorse utilizzando le etichette.

Prima di iniziare

• Leggi la documentazione relativa ai dischi permanenti.
• Leggi la documentazione relativa alle immagini.
• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Per saperne di più, consulta la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Cosa sono le etichette?

Un'etichetta è una coppia chiave-valore che puoi assegnare alle istanze Google Cloud . Ti aiutano a organizzare queste risorse e a gestire i costi su larga scala, con la granularità di cui hai bisogno. Puoi collegare un'etichetta a ogni risorsa, quindi filtrare le risorse in base alle etichette. Le informazioni relative alle etichette vengono inoltrate al sistema di fatturazione che ti consente di suddividere gli addebiti fatturati per etichetta. Con i report sulla fatturazione integrati, puoi filtrare e raggruppare i costi in base alle etichette delle risorse. Puoi anche utilizzare le etichette per interrogare le esportazioni dei dati di fatturazione.

Requisiti per le etichette

Le etichette applicate a una risorsa devono soddisfare i seguenti requisiti:

• Ogni risorsa può avere fino a 64 etichette.
• Ogni etichetta deve essere una coppia chiave-valore.
• Le chiavi hanno una lunghezza minima di 1 carattere e una lunghezza massima di 63 caratteri e non possono essere vuote. I valori possono essere vuoti e avere una lunghezza massima di 63 caratteri.
• Le chiavi e i valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Tutti i caratteri devono utilizzare la codifica UTF-8 e sono consentiti i caratteri internazionali. Le chiavi devono iniziare con una lettera minuscola o un carattere internazionale.
• La parte della chiave di un'etichetta deve essere univoca all'interno di una singola risorsa. Tuttavia, puoi utilizzare la stessa chiave con più risorse.

Questi limiti si applicano alla chiave e al valore di ogni etichetta e alle singole risorse Google Cloud che hanno etichette. Non esiste un limite al numero di etichette che puoi applicare a tutte le risorse all'interno di un progetto.

Utilizzi comuni delle etichette

Ecco alcuni casi d'uso comuni per le etichette:

• Etichette per team o centro di costo: aggiungi etichette basate su team o centro di costo per distinguere le istanze di proprietà di team diversi (ad esempio, team:research e team:analytics). Puoi utilizzare questo tipo di etichetta per la contabilità dei costi o la definizione del budget.

• Etichette dei componenti: ad esempio, component:redis, component:frontend, component:ingest e component:dashboard.

• Etichette di ambiente o fase: ad esempio, environment:production e environment:test.

• Etichette di stato: ad esempio, state:active, state:readytodelete e state:archive.

• Etichette di proprietà: utilizzate per identificare i team responsabili delle operazioni, ad esempio: team:shopping-cart.

• Etichette della macchina virtuale: un'etichetta può essere collegata a una macchina virtuale. I tag della macchina virtuale che hai definito in passato vengono visualizzati come etichetta senza un valore.

Non è consigliabile creare un numero elevato di etichette uniche, ad esempio per timestamp o valori individuali per ogni chiamata API. Il problema di questo approccio è che quando i valori cambiano frequentemente o con chiavi che ingombrano il catalogo, diventa difficile filtrare e generare report in modo efficace sulle risorse.

Etichette e tag

Le etichette possono essere utilizzate come annotazioni interrogabili per le risorse, ma non possono essere utilizzate per impostare condizioni per i criteri. I tag forniscono un modo per consentire o negare in modo condizionale i criteri a seconda che una risorsa abbia un tag specifico, fornendo un controllo granulare sui criteri. Per ulteriori informazioni, consulta la panoramica dei tag.

Utilizzare le etichette su Compute Engine

Puoi applicare etichette alle seguenti risorse Compute Engine:

• Istanze di macchine virtuali (VM)
• Immagini
• Dischi permanenti
• Snapshot di dischi permanenti

Puoi utilizzare le etichette anche su componenti correlati, Google Cloud come i seguenti:

• Bucket Cloud Storage
• Risorse di networking:
  • Regole di forwarding utilizzate con i bilanciatori del carico delle applicazioni interni (le altre regole di forwarding del bilanciatore del carico non sono supportate)
  • Tunnel VPN (anteprima)
  • Indirizzi IP esterni statici (anteprima)

Ad esempio, puoi aggiungere le seguenti etichette alle risorse sotto forma di coppie chiave/valore:

{
 "labels": {
    "vmrole": "webserver",
    "environment": "production",
    "location": "west",...
    }
 }

Creare risorse con etichette

Quando crei una nuova risorsa, puoi applicarle delle etichette.

gcloud compute instances create ... \
    --labels webserver=backend,media=images

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances

{
 "name": "myVM",
 "machineType": "zones/us-central1-f/machineTypes/custom-2-15360-ext",
  ...,
 "labels": {
   "webserver": "backend",
   "media": "images"
  }
}

Aggiungere o aggiornare le etichette delle risorse esistenti

Puoi aggiungere etichette o aggiornare quelle esistenti sulle risorse utilizzando la consoleGoogle Cloud , gcloud CLI o l'API Compute Engine. Per aggiungere o aggiornare le etichette per le regole di forwarding, utilizza gcloud CLI o l'API Compute Engine.

gcloud compute disks update example-disk \
    --update-labels backend=webserver,media=images

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance/setLabels

{
 "labels": {
  "environment": "test",
  "an-existing-tag": "yes"
 },
 "labelFingerprint": "42WmSpB8rSM="
}

Visualizza etichette

Puoi visualizzare le etichette delle risorse utilizzando la console Google Cloud , gcloud CLI o l'API Compute Engine. Per visualizzare le etichette per le regole di forwarding, utilizza gcloud CLI o l'API Compute Engine.

gcloud compute disks describe example-disk

...
id: '5047929990219134234'
kind: compute#disk
labelFingerprint: GHZ1Un209U=0
labels:
  environment: dev
  department: finance
...

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

Ottenere un fingerprint dell'etichetta per le richieste API

Quando aggiorni o aggiungi etichette nell'API, devi fornire l'impronta delle etichette più recenti con la tua richiesta, per evitare conflitti con altre richieste. Un'impronta è richiesta solo per le richieste API; Google Cloud console e lo strumento Google Cloud CLI non richiedono un'impronta.

Per ottenere l'ultima versione di labelsFingerprint, invia una richiesta GET alle seguenti risorse:

• Per le istanze VM, utilizza il metodo instances.get().
• Per gli snapshot, utilizza il metodo snapshots.get().
• Per le immagini, utilizza il metodo images.get().
• Per i dischi, utilizza il metodo disks.get().
• Per le regole di forwarding, utilizza il metodo forwardingRules.get().
• Per gli indirizzi IP esterni statici regionali, utilizza il metodo beta addresses.get().
• Per gli indirizzi IP esterni statici globali, utilizza il metodo beta globalAddresses.get().
• Per i tunnel VPN, utilizza il metodo beta vpnTunnels.get().

Ad esempio, il seguente snippet recupera un labelsFingerprint per un'istanza VM:

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance

La risposta contiene la proprietà labelFingerprint:

200 OK

{
 "kind": "compute#instance",
 "id": "4392196237934605253",
 "creationTimestamp": "2015-09-15T14:05:16.475-07:00",
 "zone": "https://content.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f",
 "status": "RUNNING",
 ...
 "labels": {
  "environment": "test"
 },
 "labelFingerprint": "p1ty_9HoBk0="
}

Rimuovere un'etichetta

Puoi rimuovere le etichette dalle risorse utilizzando la console Google Cloud , gcloud CLI o l'API Compute Engine. Per rimuovere le etichette per le regole di forwarding, utilizza gcloud CLI o l'API Compute Engine.

gcloud compute disks update example-disk \
    --remove-labels backend,media

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance/setLabels

{
 "labels": { },
 "labelFingerprint": "42WmSpB8rSM="
}

Filtrare le ricerche utilizzando le etichette

Puoi cercare le tue risorse e filtrare i risultati per etichette utilizzando la consoleGoogle Cloud , gcloud CLI o l'API Compute Engine. Per filtrare le regole di forwarding in base alle etichette, utilizza gcloud CLI o l'API Compute Engine.

gcloud compute instances list \
    --filter labels.env=dev

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances?filter=labels.env%3Adev

Relazione tra etichette e tag delle VM

In passato, etichette e tag erano correlati. Ad esempio, se hai aggiunto un'etichetta webserver:test a una VM, Compute Engine ha aggiunto automaticamente un tag webserver alla VM.

Ora le etichette e i tag sono separati. Se crei un'etichetta su una VM, Compute Engine non crea un tag per la VM. Se devi creare un tag su una VM, devi crearlo manualmente.

Per saperne di più sui tag e sui loro utilizzi, consulta Panoramica dei tag.

Passaggi successivi

• Scopri come confrontare i tag e i tag di rete.
• Scopri come gestire i tag per le risorse Compute Engine.
• Esamina il parametro di query filter per scoprire di più sul filtraggio.