Questo documento fornisce dettagli 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 supportano le etichette.
Creare etichette per i progetti
Console
Per aggiungere etichette a un singolo progetto:
Apri la pagina Etichette nella console Google Cloud.
Seleziona il progetto dal menu a discesa Seleziona un progetto.
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.
Al termine dell'aggiunta delle etichette, fai clic su Salva.
Per aggiungere etichette per più progetti contemporaneamente:
Apri la pagina Gestisci risorse nella console Google Cloud.
Nella pagina Gestisci risorse, seleziona i progetti per i quali vuoi aggiungere le etichette.
Nel riquadro delle informazioni, fai clic su + Aggiungi etichetta nella scheda Etichette e inserisci una chiave e un valore per ogni etichetta da aggiungere.
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 dell'etichetta nella casella del filtro sopra l'elenco dei progetti. La casella del filtro suggerisce 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 per i progetti esistenti:
- Recupera il progetto utilizzando il metodo
projects.get()
. - Modifica il campo
labels
. - Aggiorna il progetto utilizzando il metodo
projects.patch()
.
Dopo aver aggiunto le etichette, puoi filtrare i progetti in base a queste. Per informazioni dettagliate sull'utilizzo delle etichette per filtrare i progetti, consulta Progetti elenco.
Aggiornare le etichette dei progetti
Console
Per aggiornare le etichette di un singolo progetto:Apri la pagina Etichette nella console Google Cloud.
Seleziona il progetto dal menu a discesa Seleziona un progetto.
Aggiorna le etichette del progetto:
- Per modificare un'etichetta, fai clic sul valore che vuoi modificare e apporta le modifiche necessarie.
- Per eliminare un'etichetta, tieni premuto il cursore sulla chiave o sul valore, quindi fai clic su .
Al termine dell'aggiornamento delle etichette, fai clic su Salva.
Per aggiornare le etichette di più progetti contemporaneamente:
Apri la pagina Gestisci risorse nella console Google Cloud.
Nella pagina Gestisci risorse, seleziona i progetti per i quali vuoi aggiornare le etichette.
Nel riquadro delle informazioni, fai clic sulla scheda Etichette e aggiorna le etichette per i progetti selezionati:
- Per modificare un'etichetta, fai clic sul valore che vuoi modificare e apporta le modifiche necessarie.
- Per eliminare un'etichetta, tieni premuto il cursore sulla chiave o sul valore, quindi fai clic su .
Al termine dell'aggiornamento delle etichette, fai clic su Salva.
REST
Per aggiornare le etichette di un progetto:
Recupera l'oggetto
project
utilizzando il metodoprojects.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 da 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"
},
}
]
}