Creare e aggiornare le etichette per i progetti

Questo documento fornisce informazioni dettagliate su come creare e aggiornare le etichette per i progetti utilizzando l'API Resource Manager e la console Google Cloud . Fornisce dettagli su come comprendere i costi utilizzando le etichette e i servizi che le supportano.

Creare 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 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 a cui vuoi aggiungere etichette.

  3. Nel riquadro delle 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 del filtro sopra l'elenco dei progetti. La casella del filtro suggerirà chiavi e valori per consentirti di 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 ai progetti esistenti:

Una volta aggiunte le etichette, puoi filtrare i progetti in base a queste. Per informazioni dettagliate sull'utilizzo delle etichette per filtrare i progetti, consulta Elenco dei progetti.

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 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 e poi 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 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 delle 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 e poi 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.

REST

Per aggiornare le etichette di un progetto:

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

  • Modifica le etichette che vuoi aggiornare.

  • Chiama il metodo projects.patch.

L'esempio seguente aggiorna 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/projects/PROJECT_NAME {   updateMask=labels } 

dove PROJECT_NAME è il nome del progetto che vuoi aggiornare.

Corpo JSON della 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"         },     }     ] }