Creazione e gestione delle etichette

In questa pagina viene fornita una breve panoramica delle etichette e viene spiegato come creare e gestire le etichette utilizzando l'API Resource Manager e Google Cloud Console.

Cosa sono le etichette?

Un'etichetta è una coppia chiave-valore che ti aiuta a organizzare le risorse di Google Cloud. Puoi collegare un'etichetta a ciascuna risorsa e quindi filtrare le risorse in base alle etichette. Le informazioni sulle etichette vengono inoltrate al sistema di fatturazione, in modo da poter suddividere gli addebiti fatturati per etichetta.

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

Etichette e tag

I tag sono uno strumento separato che viene utilizzato per fornire un controllo granulare sui criteri. Per ulteriori informazioni sui tag, consulta la panoramica sui tag.

Utilizzi comuni delle etichette

Sconsigliamo di creare un numero elevato di etichette univoche, ad esempio per timestamp o singoli valori per ogni chiamata API. Ecco alcuni casi d'uso comuni delle etichette:

  • Etichette del team o del centro di costo: aggiungi etichette basate sul team o sul centro di costo per distinguere le risorse 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 di fase: ad esempio, environment:production e environment:test.

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

  • Etichette di macchine virtuali: è possibile collegare un'etichetta a una macchina virtuale. I tag delle macchine virtuali che hai definito in passato verranno visualizzati come etichetta senza un valore.

Requisiti per le etichette

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

  • Ogni risorsa può avere più etichette, fino a un massimo di 64.
  • Ogni etichetta deve essere una coppia chiave-valore.
  • Le chiavi devono avere una lunghezza minima di 1 carattere e 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.
  • La parte chiave di un'etichetta deve essere univoca all'interno di una singola risorsa. Tuttavia, puoi utilizzare la stessa chiave con più risorse.
  • Le chiavi devono iniziare con una lettera minuscola o un carattere internazionale.

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

Autorizzazioni

Puoi aggiungere o modificare un'etichetta chiamando il metodo projects.projects.patch(). Questa operazione richiede l'autorizzazione resourcemanager.projects.update.

Per visualizzare l'etichetta di un progetto è necessario chiamare il metodo projects.get(). Questa operazione richiede l'autorizzazione resourcemanager.projects.get.

Crea etichette

Console

Per aggiungere etichette a un singolo progetto:

  1. Apri la pagina Etichette nella console Google Cloud.

    Apri la pagina Etichette

  2. Seleziona il progetto nel menu a discesa Seleziona un progetto.

  3. Per aggiungere una nuova voce di etichetta, fai clic su + Aggiungi etichetta e inserisci una chiave e un valore etichetta per ogni etichetta che vuoi aggiungere.

  4. Dopo avere aggiunto le etichette, fai clic su Salva.

Per aggiungere etichette per più progetti contemporaneamente:

  1. Apri la pagina Gestisci risorse in Google Cloud Console.

    Apri la pagina Gestisci risorse

  2. Nella pagina Gestisci risorse, seleziona i progetti per i quali vuoi aggiungere etichette.

  3. Nel riquadro informazioni, nella scheda Etichette, fai clic su + Aggiungi etichetta e inserisci una chiave e un valore etichetta per ogni etichetta da aggiungere.

  4. Dopo avere aggiunto le etichette, fai clic su Salva.

Dopo aver aggiunto le etichette, puoi filtrare i progetti digitando una chiave di etichetta o un valore nella casella del filtro sopra l'elenco dei progetti. La casella del filtro suggerirà chiavi e valori per visualizzare l'anteprima dei risultati.

REST

Per creare un nuovo progetto con un'etichetta, imposta il campo labels quando crei il progetto.

Richiesta:

POST https://cloudresourcemanager.googleapis.com/v3/projects

{
 "labels": {
  "color": "red"
 },
 "name": "myproject",
 "projectId": "our-project-123"
}

Risposta:


{
 "projectNumber": "333197460082",
 "projectId": "our-project-123",
 "lifecycleState": "ACTIVE",
 "name": "myproject",
 "labels": {
  "color": "red"
 },
 "createTime": "2016-01-12T22:18:28.633Z",
}

Per aggiungere etichette per progetti esistenti:

Dopo aver aggiunto le etichette, puoi filtrare i progetti in base alle etichette. Per maggiori dettagli sull'utilizzo delle etichette per filtrare i progetti, vedi Elenco dei progetti.

Aggiorna etichette

Console

Per aggiornare le etichette di un singolo progetto:

  1. Apri la pagina Etichette nella console Google Cloud.

    Apri la pagina Etichette

  2. Seleziona il progetto nel menu a discesa Seleziona un progetto.

  3. Aggiorna le etichette per il progetto:

    1. Per modificare un'etichetta, fai clic sul valore che vuoi modificare, poi apporta le modifiche che preferisci.
    2. Per eliminare un'etichetta, tieni il puntatore del mouse sopra la chiave o il valore, quindi fai clic su .
  4. Dopo avere aggiornato le etichette, fai clic su Salva.

Per aggiornare le etichette di più progetti contemporaneamente:

  1. Apri la pagina Gestisci risorse in Google Cloud Console.

    Apri la pagina Gestisci risorse

  2. Nella pagina Gestisci risorse, seleziona i progetti per i quali vuoi aggiornare le etichette.

  3. Nel riquadro informazioni, fai clic sulla scheda Etichette e aggiorna le etichette per i progetti selezionati:

    1. Per modificare un'etichetta, fai clic sul valore che vuoi modificare, poi apporta le modifiche che preferisci.
    2. Per eliminare un'etichetta, tieni il puntatore del mouse sopra la chiave o il valore, quindi fai clic su .
  4. Dopo avere aggiornato le etichette, fai clic su Salva.

REST

Per aggiornare le etichette di un progetto:

  • Recupera l'oggetto project utilizzando il metodo projects.get().

  • Modifica le etichette che vuoi aggiornare.

  • Chiama il metodo projects.patch.

Nell'esempio seguente viene aggiornata l'etichetta color:blue:

Il seguente snippet di codice modifica il valore dell'etichetta color da blue a red.

Richiesta:

PATCH https://cloudresourcemanager.googleapis.com/v3/{project.name=PROJECT_NAME}
{
  updateMask=labels
}

Dove PROJECT_NAME è il nome del progetto che vuoi aggiornare.

Corpo JSON richiesta:

{
    "labels":
      {
        "color": "red"
      }
}

Risposta:

{
    "projects": [
    {
        "name": "projects/123456789012",
        "parent": "folders/123456789012",
        "projectId": "my-project",
        "state": "ACTIVE",
        "displayName": "PROJECT_NAME"
        "createTime": "2013-11-13T20:31:53.308Z"
        "updateTime": "2013-11-13T20:35:42.308Z"
        "etag": "BwWUlZ6XEfY="
        "labels": {
            "color": "red"
        },
    }
    ]
}

Servizi che supportano le etichette

I seguenti servizi di Google Cloud supportano le etichette:

  • AI Platform
  • App Engine (ambienti sia standard che flessibili)
  • Artifact Registry
  • BigQuery
  • Certificate Authority Service
  • Cloud Bigtable
  • Cloud Composer
  • Cloud Deployment Manager
  • Cloud Functions
  • API Cloud Healthcare
  • Cloud Key Management Service
  • Cloud Run
  • Cloud Spanner
  • Cloud SQL
  • Cloud Storage
  • Cloud Translation
  • Compute Engine
  • Dataflow
  • Dataproc
  • Filestore
  • Google Kubernetes Engine
  • Memorystore
  • Networking
  • Pub/Sub
  • reCAPTCHA Enterprise
  • Resource Manager (solo progetti)
  • API Transcoder
  • Vertex AI