Creare e aggiornare le etichette per i progetti

Le etichette ti consentono di organizzare i tuoi progetti Google Cloud e monitorare i costi tra team o ambienti. Per gestire le etichette dei progetti, puoi utilizzare la consoleGoogle Cloud , Google Cloud CLI o l'API Cloud Resource Manager.

Le etichette si applicano solo ai progetti. Le cartelle e le risorse dell'organizzazione non supportano le etichette e le etichette che colleghi a un progetto non vengono propagate automaticamente alle risorse figlio. Per applicare o aggiornare le etichette su risorse di servizio specifiche, come istanze Compute Engine o bucket Cloud Storage, consulta la documentazione della risorsa o Servizi che supportano le etichette. Ad esempio, Pub/Sub supporta le etichette per la fatturazione della velocità effettiva di argomenti e sottoscrizioni, ma gli SKU di fatturazione del traffico in uscita non supportano le etichette.

Crea etichette per i progetti

Console

Per aggiungere etichette a un singolo progetto:

  1. Apri la pagina Etichette nella console Google Cloud .

    Apri la pagina Etichette

  2. Seleziona il tuo progetto dal 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 per ogni etichetta che vuoi aggiungere.

  4. Al termine dell'aggiunta delle etichette, fai clic su Salva.

Per aggiungere etichette per più progetti contemporaneamente:

  1. Apri la pagina Gestisci risorse nella console Google Cloud .

    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 per ogni etichetta che vuoi aggiungere.

  4. Al termine dell'aggiunta delle etichette, fai clic su Salva.

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

gcloud

Per creare un nuovo progetto con etichette utilizzando gcloud CLI, utilizza il comando gcloud projects create con il flag --labels:

gcloud projects create PROJECT_ID \
    --labels=KEY1=VALUE1,KEY2=VALUE2

Per aggiungere etichette a un progetto esistente, utilizza il comando gcloud projects update con il flag --update-labels:

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

Dove:

  • PROJECT_ID è l'ID del progetto che vuoi creare o aggiornare.
  • KEY1=VALUE1 è una coppia chiave-valore per l'etichetta che vuoi aggiungere.

REST

Per creare un nuovo progetto con un'etichetta, includi il campo labels quando effettui una richiesta POST al metodo projects.create:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "PROJECT_ID",
    "displayName": "PROJECT_NAME",
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects"

Per aggiungere etichette a un progetto esistente, utilizza il metodo projects.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

Aggiorna le etichette per i progetti

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 tuo progetto dal menu a discesa Seleziona un progetto.

  3. Aggiorna le etichette del progetto:

    1. Per modificare un'etichetta, fai clic sul valore da modificare, quindi apporta le modifiche desiderate.
    2. Per eliminare un'etichetta, tieni il puntatore sulla chiave o sul valore, quindi fai clic su .

  4. Al termine dell'aggiornamento delle etichette, fai clic su Salva.

Per aggiornare le etichette di più progetti contemporaneamente:

  1. Apri la pagina Gestisci risorse nella console Google Cloud .

    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 da modificare, quindi apporta le modifiche desiderate.
    2. Per eliminare un'etichetta, tieni il puntatore sulla chiave o sul valore, quindi fai clic su .

  4. Al termine dell'aggiornamento delle etichette, fai clic su Salva.

gcloud

Per aggiornare le etichette di un progetto utilizzando gcloud CLI, utilizza il comando gcloud projects update con il flag --update-labels, --remove-labels o --clear-labels.

Per aggiungere o aggiornare le etichette:

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

Per rimuovere etichette specifiche:

gcloud projects update PROJECT_ID \
    --remove-labels=KEY1,KEY2

Per rimuovere tutte le etichette da un progetto:

gcloud projects update PROJECT_ID \
    --clear-labels

REST

Per aggiornare le etichette di un progetto utilizzando l'API, invia una richiesta PATCH al metodo projects.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "color": "red"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

Dove PROJECT_ID è l'ID del progetto che vuoi aggiornare.