Creare e aggiornare le etichette per i progetti

Questo documento fornisce dettagli su come creare e aggiornare le etichette per i progetti utilizzando gcloud CLI, l'API Cloud Resource Manager e la Google Cloud console.

Creare etichette per i progetti

Console

Per aggiungere etichette a un singolo progetto:

  1. Apri la pagina Etichette nella Google Cloud console.

    Apri la pagina Etichette

  2. Seleziona il 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 di etichetta e un valore per ogni etichetta che vuoi aggiungere.

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

Per aggiungere etichette a più progetti contemporaneamente:

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

    Apri la pagina Gestisci risorse

  2. Nella pagina Gestisci risorse, seleziona i progetti a cui vuoi aggiungere le etichette.

  3. Nel riquadro informazioni, nella scheda Etichette, fai clic su + Aggiungi etichetta e inserisci una chiave di etichetta 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 di etichetta o un valore nella casella di filtro sopra l'elenco dei progetti. La casella di filtro suggerirà chiavi e valori in modo da poter visualizzare l'anteprima dei risultati.

gcloud

Per creare un nuovo progetto con le 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"

Aggiornare le etichette per i progetti

Console

Per aggiornare le etichette per un singolo progetto:

  1. Apri la pagina Etichette nella Google Cloud console.

    Apri la pagina Etichette

  2. Seleziona il progetto dal 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, quindi apporta le modifiche desiderate.
    2. Per eliminare un'etichetta, tieni il puntatore sopra la chiave o il valore, quindi fai clic su .

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

Per aggiornare le etichette per più progetti contemporaneamente:

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

    Apri la pagina Gestisci risorse

  2. Nella pagina Gestisci risorse, seleziona i progetti per cui 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, quindi apporta le modifiche desiderate.
    2. Per eliminare un'etichetta, tieni il puntatore sopra la chiave o il 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.