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