Creazione e gestione dei tag

Console

Per creare una chiave tag:

1. Apri la pagina Tag nella console Google Cloud .

   Apri la pagina Tag

2. Nel selettore di ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto in cui vuoi creare una chiave tag.

3. Fai clic su add Crea.

4. Nella casella Chiave tag, inserisci il nome visualizzato della chiave tag. Questo diventa parte del nome spazio dei nomi del tag.

5. Nella casella Descrizione chiave tag, inserisci una descrizione della chiave tag.

6. Se vuoi aggiungere valori tag a questa chiave, fai clic su add Aggiungi valore per ogni valore tag che vuoi creare.

7. Nella casella Valore tag, inserisci il nome visualizzato del valore del tag. Questo diventa parte del nome spazio dei nomi del tag.

8. Nella casella Descrizione del valore tag, inserisci una descrizione del valore tag.

9. Quando hai finito di aggiungere i valori dei tag, fai clic su Crea chiave tag.

gcloud

Per creare una chiave tag, utilizza il comando gcloud resource-manager tags keys create:

gcloud resource-manager tags keys create SHORT_NAME \
    --parent=RESOURCE_ID

Dove:

• SHORT_NAME è il nome visualizzato della chiave tag, ad esempio environment.

• RESOURCE_ID è l'ID dell'organizzazione o della risorsa progetto padre per questa chiave tag; ad esempio: organizations/123456789012, projects/test-project123 o projects/234567890123. Per scoprire come ottenere l'ID organizzazione, consulta la pagina Creare e gestire le organizzazioni. Per scoprire come ottenere l'ID progetto, vedi Creazione e gestione dei progetti.

Dovresti ricevere una risposta simile alla seguente:

Creating tag key environment in organization 1234567890...
<blocking wait until creation completes>
name: tagKeys/123456789012
short_name: environment
namespaced_name: 123456789012/environment
parent: organizations/123456789012

Terraform

Utilizza la risorsa google_tags_tag_key.

Prima di creare chiavi tag utilizzando Terraform, abilita l'API Cloud Resource Manager.

L'esempio seguente crea chiavi tag denominate env e department:

data "google_project" "default" {}

resource "google_tags_tag_key" "env_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "env"
}

resource "google_tags_tag_key" "department_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "department"
}

Per applicare la configurazione di Terraform in un progetto Google Cloud , completa i passaggi nelle sezioni seguenti.

Prepara Cloud Shell

1. Avvia Cloud Shell.

2. Imposta il progetto Google Cloud predefinito in cui vuoi applicare le configurazioni Terraform.

   Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.

Prepara la directory

Ogni file di configurazione di Terraform deve avere la propria directory (chiamata anche modulo radice).

1. In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file viene denominato main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

   Copia il codice campione nel file main.tf appena creato.

   (Facoltativo) Copia il codice da GitHub. Questa operazione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

3. Rivedi e modifica i parametri di esempio da applicare al tuo ambiente.
4. Salva le modifiche.
5. Inizializza Terraform. Devi effettuare questa operazione una sola volta per directory.

   terraform init

   (Facoltativo) Per utilizzare l'ultima versione del provider Google, includi l'opzione -upgrade:

   terraform init -upgrade

Applica le modifiche

1. Rivedi la configurazione e verifica che le risorse che Terraform creerà o aggiornerà corrispondano alle tue aspettative:

   terraform plan

   Apporta le correzioni necessarie alla configurazione.

2. Applica la configurazione di Terraform eseguendo il comando seguente e inserendo yes al prompt:

   terraform apply

   Attendi che Terraform visualizzi il messaggio "Apply complete!" (Applicazione completata).

3. Apri il tuo Google Cloud progetto per visualizzare i risultati. Nella console Google Cloud , vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

API

Per creare una chiave tag, crea una rappresentazione JSON della chiave. Per ulteriori informazioni sul formato di una chiave tag, consulta la documentazione di riferimento di TagKey.

Dopodiché, utilizza il metodo tagKeys.create:

POST https://cloudresourcemanager.googleapis.com/v3/tagKeys/ -d

Corpo JSON della richiesta:

{
    "parent": RESOURCE_ID,
    "shortName": SHORT_NAME,
    "description": DESCRIPTION,
}

Dove:

• SHORT_NAME è il nome visualizzato della chiave tag, ad esempio environment.

• RESOURCE_ID è l'ID dell'organizzazione o della risorsa progetto padre per questa chiave tag; ad esempio: organizations/123456789012, projects/test-project123 o projects/234567890123. Per scoprire come ottenere l'ID organizzazione, consulta la pagina Creare e gestire le organizzazioni. Per scoprire come ottenere l'ID progetto, vedi Creazione e gestione dei progetti.

• DESCRIPTION è una descrizione della chiave e non può contenere più di 256 caratteri.

Console

Per visualizzare un tag creato:

1. Apri la pagina Tag nella console Google Cloud .

   Apri la pagina Tag

2. Nel selettore di ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene il tag.

3. Nell'elenco vengono visualizzati tutti i tag dell'organizzazione o del progetto selezionato. Fai clic sul tag per cui vuoi visualizzare la chiave tag.

gcloud

Per visualizzare le informazioni relative a una determinata chiave tag, utilizza il comando gcloud resource-manager tags keys describe:

gcloud resource-manager tags keys describe TAGKEY_NAME

TAGKEY_NAME è l'ID permanente o il nome con spazio dei nomi della chiave del tag per cui vuoi visualizzare le informazioni; ad esempio: tagKeys/123456789012 o project-id/environment.

Dovresti ricevere una risposta simile alla seguente:

name: tagKeys/123456789012
short_name: environment
namespaced_name: 123456789012/environment
parent: organizations/123456789012

API

Per visualizzare le informazioni relative a una determinata chiave tag, utilizza il metodo tagKeys.get:

GET https://cloudresourcemanager.googleapis.com/v3/{name=TAGKEY_NAME}

TAGKEY_NAME è l'ID permanente della chiave del tag per cui vuoi visualizzare le informazioni; ad esempio: tagKeys/123456789012.

Per visualizzare le informazioni relative a una determinata chiave di tag utilizzando il nome con spazio dei nomi, utilizza il metodo tagKeys.getNamespaced:

GET https://cloudresourcemanager.googleapis.com/v3/tagKeys/namespaced?name={TAGKEY_NAMESPACED_NAME}

TAGKEY_NAMESPACED_NAME è il nome con spazio dei nomi della chiave tag e ha il formato parentNamespace/tagKeyShortName.

Console

Per creare un valore tag:

1. Apri la pagina Tag nella console Google Cloud .

   Apri la pagina Tag

2. Nel selettore di ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto in cui vuoi creare un valore tag.

3. Nell'elenco dei tag, fai clic sul tag a cui vuoi aggiungere un nuovo valore.

4. Fai clic su add Aggiungi valore.

5. Nella casella Valore tag, inserisci il nome visualizzato del valore del tag. Questo diventa parte del nome spazio dei nomi del tag.

6. Nella casella Descrizione del valore tag, inserisci una descrizione del valore tag.

7. Fai clic su Salva.

gcloud

Per creare un valore tag, utilizza il comando gcloud resource-manager tags values create. Devi specificare la chiave in cui viene creato questo valore:

gcloud resource-manager tags values create TAGVALUE_SHORTNAME \
    --parent=TAGKEY_NAME

Dove:

• TAGVALUE_SHORTNAME è il nome breve del nuovo valore tag, ad esempio production.

• TAGKEY_NAME è l'ID permanente o il nome con spazio dei nomi della chiave tag principale; ad esempio: tagKeys/4567890123.

Dovresti ricevere una risposta simile alla seguente:

Creating tag value production in tag key 123456789012/environment...
<blocking wait until creation completes>
name: tagValues/7890123456
short_name: production
namespaced_name: 123456789012/environment/production
parent: tagKeys/123456789012

Terraform

Utilizza la risorsa google_tags_tag_value.

Prima di creare valori dei tag utilizzando Terraform, abilita l'API Cloud Resource Manager.

Il seguente esempio crea valori tag denominati prod e sales:

data "google_project" "default" {}

resource "google_tags_tag_key" "env_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "env1"
}

resource "google_tags_tag_key" "department_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "department1"
}

resource "google_tags_tag_value" "env_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.env_tag_key.name}"
  short_name = "prod"
}

resource "google_tags_tag_value" "department_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.department_tag_key.name}"
  short_name = "sales"
}

Per applicare la configurazione di Terraform in un progetto Google Cloud , completa i passaggi nelle sezioni seguenti.

Prepara Cloud Shell

1. Avvia Cloud Shell.

2. Imposta il progetto Google Cloud predefinito in cui vuoi applicare le configurazioni Terraform.

   Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.

Prepara la directory

Ogni file di configurazione di Terraform deve avere la propria directory (chiamata anche modulo radice).

1. In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file viene denominato main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

   Copia il codice campione nel file main.tf appena creato.

   (Facoltativo) Copia il codice da GitHub. Questa operazione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

3. Rivedi e modifica i parametri di esempio da applicare al tuo ambiente.
4. Salva le modifiche.
5. Inizializza Terraform. Devi effettuare questa operazione una sola volta per directory.

   terraform init

   (Facoltativo) Per utilizzare l'ultima versione del provider Google, includi l'opzione -upgrade:

   terraform init -upgrade

Applica le modifiche

1. Rivedi la configurazione e verifica che le risorse che Terraform creerà o aggiornerà corrispondano alle tue aspettative:

   terraform plan

   Apporta le correzioni necessarie alla configurazione.

2. Applica la configurazione di Terraform eseguendo il comando seguente e inserendo yes al prompt:

   terraform apply

   Attendi che Terraform visualizzi il messaggio "Apply complete!" (Applicazione completata).

3. Apri il tuo Google Cloud progetto per visualizzare i risultati. Nella console Google Cloud , vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

API

Per creare un valore tag, crea una rappresentazione JSON del valore. Per ulteriori informazioni sul formato di un valore di tag, consulta la documentazione di riferimento di TagValue.

Quindi, utilizza il metodo tagValues.create:

POST https://cloudresourcemanager.googleapis.com/v3/tagValues/ -d

Corpo JSON della richiesta:

{
    "parent": TAGKEY_NAME,
    "shortName": SHORT_NAME,
    "description": DESCRIPTION,
}

Dove:

• TAGKEY_NAME è l'ID permanente della chiave tag principale; ad esempio:tagKeys/4567890123.

• SHORT_NAME è il nome visualizzato del valore tag; ad esempio: environment.

• DESCRIPTION è una descrizione del valore e non può contenere più di 256 caratteri. Dopo aver creato il valore, puoi trovare il nome visualizzato univoco leggibile chiamato namespacedName, che si trova nello spazio dei nomi della risorsa principale, e un ID permanente univoco a livello globale chiamato name.

Console

Per visualizzare un tag creato:

1. Apri la pagina Tag nella console Google Cloud .

   Apri la pagina Tag

2. Nel selettore di ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene il tag.

3. Nell'elenco vengono visualizzati tutti i tag che hai creato in questa organizzazione o in questo progetto. Fai clic sul tag di cui vuoi visualizzare i valori.

gcloud

Per visualizzare le informazioni relative a un determinato valore del tag, utilizza il comando gcloud resource-manager tags values describe:

gcloud resource-manager tags values describe TAGVALUE_NAME

TAGVALUE_NAME è l'ID permanente o il nome con spazio dei nomi del valore tag; ad esempio: tagValues/4567890123 o 123456789012/environment/production.

Dovresti ricevere una risposta simile alla seguente:

name: tagValues/456789012345
short_name: production
namespaced_name: 123456789012/environment/production
parent: tagKeys/123456789012

API

Per visualizzare le informazioni relative a un determinato valore del tag, utilizza il metodo tagValues.get:

GET https://cloudresourcemanager.googleapis.com/v3/{name=TAGVALUE_NAME}

TAGVALUE_NAME è l'ID permanente del valore del tag; ad esempio: tagValues/4567890123.

Per visualizzare le informazioni relative a un determinato valore del tag utilizzando il relativo nome con spazio dei nomi, utilizza il metodo tagValues.getNamespaced:

GET https://cloudresourcemanager.googleapis.com/v3/tagValues/namespaced?name={TAGVALUE_NAMESPACED_NAME}

TAGVALUE_NAMESPACED_NAME è il nome con spazio dei nomi del valore tag e ha il formato parentNamespace/tagKeyShortName/tagValueShortName.

Console

Per aggiornare la descrizione di una chiave tag:

1. Apri la pagina Tag nella console Google Cloud .

   Apri la pagina Tag

2. Nel selettore di ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene la chiave tag.

3. Fai clic su more_vert Azioni accanto alla chiave del tag che vuoi aggiornare, quindi fai clic su Visualizza dettagli.

4. Fai clic su edit Modifica accanto a Descrizione nella parte superiore dello schermo.

5. Aggiorna la descrizione della chiave tag.

6. Fai clic su Salva.

gcloud

Per modificare la descrizione di una chiave tag, utilizza il comando gcloud resource-manager tags keys update:

gcloud resource-manager tags keys update TAGKEY_NAME \
    --description=NEW_DESCRIPTION

Dove:

• TAGKEY_NAME è l'ID permanente o il nome con spazio dei nomi della chiave da aggiornare; ad esempio: tagKeys/123456789012.

• NEW_DESCRIPTION è una stringa di massimo 256 caratteri da utilizzare come nuova descrizione.

Dovresti ricevere una risposta simile alla seguente:

name: tagKeys/123456789012
short_name: environment
namespaced_name: 123456789012/environment
description: "new description"
parent: organizations/123456789012

API

Per modificare la descrizione di una chiave tag, utilizza il metodo tagKeys.patch:

PATCH https://cloudresourcemanager.googleapis.com/v3/{tagKey.name=TAGKEY_NAME} -d

Corpo JSON della richiesta:

{
    "description": DESCRIPTION,
}

Dove:

• TAGKEY_NAME è l'ID permanente della chiave tag; ad esempio: tagKeys/123456789012.

• DESCRIPTION è una descrizione della chiave e non può contenere più di 256 caratteri.

Console

Per aggiornare la descrizione di un valore tag:

1. Apri la pagina Tag nella console Google Cloud .

   Apri la pagina Tag

2. Nel selettore di ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene il valore del tag.

3. Fai clic su more_vert Azioni accanto alla chiave del tag per il valore che vuoi aggiornare, quindi fai clic su Visualizza dettagli.

4. Fai clic su more_vert Azioni accanto al valore del tag che vuoi aggiornare, poi fai clic su Visualizza dettagli.

5. Fai clic su edit Modifica accanto a Descrizione nella parte superiore dello schermo.

6. Aggiorna la descrizione del valore del tag.

7. Fai clic su Salva.

gcloud

Per modificare la descrizione di un valore tag, utilizza il comando gcloud resource-manager tags values update:

gcloud resource-manager tags values update TAGVALUE_NAME \
    --description="NEW_DESCRIPTION"

Dove:

• TAGVALUE_NAME è l'ID permanente o il nome con spazio dei nomi del valore del tag da aggiornare; ad esempio: tagValues/4567890123.

• NEW_DESCRIPTION è una stringa di massimo 256 caratteri da utilizzare come nuova descrizione.

Dovresti ricevere una risposta simile alla seguente:

short_name: production
namespaced_name: 123456789012/environment/production
parent: tagKeys/123456789012
description: "new description"

API

Per modificare la descrizione di una chiave tag, utilizza il comando tagValues.patch:

PATCH https://cloudresourcemanager.googleapis.com/v3/{tagKey.name=TAGVALUE_NAME} -d

Corpo JSON della richiesta:

{
    "description": DESCRIPTION,
}

Dove:

• TAGVALUE_NAME è il nome dell'ID permanente del valore del tag; ad esempio: tagValues/4567890123.

• DESCRIPTION è una descrizione della chiave e non può contenere più di 256 caratteri.

Console

Per visualizzare tutti i tag:

1. Apri la pagina Tag nella console Google Cloud .

   Apri la pagina Tag

2. Nel selettore di ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene i tag.

3. Nell'elenco vengono visualizzati tutti i tag che hai creato in questa organizzazione o in questo progetto.

gcloud

Per restituire un elenco di tutte le chiavi tag create in un'organizzazione o in una risorsa di progetto, utilizza il comando gcloud resource-manager tags keys list:

gcloud resource-manager tags keys list --parent=RESOURCE_ID

RESOURCE_ID è l'ID della risorsa dell'organizzazione o del progetto per cui vuoi trovare le chiavi tag associate.

• Un ID organizzazione o progetto deve essere fornito nel formato organizations/ORGANIZATION_ID o projects/PROJECT_NAME; ad esempio: organizations/123456789012 e projects/test-project123. Per scoprire come ottenere l'ID organizzazione, vedi Creare e gestire le organizzazioni. Per scoprire come ottenere l'ID progetto, vedi Creazione e gestione dei progetti. Dovresti ricevere una risposta simile alla seguente:

NAME                     SHORT_NAME      DESCRIPTION
tagKeys/123456789012     environment     description of tag key

API

Per restituire un elenco di tutte le chiavi tag per una determinata risorsa, utilizza il metodo tagKeys.list, con la risorsa padre specificata nella query:

GET https://cloudresourcemanager.googleapis.com/v3/tagKeys

{
    "parent": "RESOURCE_ID"
}

RESOURCE_ID è l'ID della risorsa dell'organizzazione o del progetto per cui vuoi trovare le chiavi tag associate; ad esempio: organizations/123456789012 e projects/test-project123.

Console

Per visualizzare tutti i valori dei tag associati a una chiave tag:

1. Apri la pagina Tag nella console Google Cloud .

   Apri la pagina Tag

2. Nel selettore di ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene la chiave tag.

3. Fai clic su more_vert Azioni accanto alla chiave tag contenente i valori tag che vuoi trovare, quindi fai clic su Visualizza dettagli.

4. Nell'elenco vengono visualizzati tutti i valori dei tag che hai creato in questa chiave tag.

gcloud

Per restituire un elenco di tutti i valori dei tag collegati a una chiave, utilizza il comando gcloud resource-manager tags values list:

gcloud resource-manager tags values list --parent=TAGKEY_NAME

TAGKEY_NAME è l'ID permanente o il nome con spazio dei nomi della chiave tag per cui vuoi trovare i valori allegati; ad esempio: tagKeys/123456789012 o 1234567/environment.

Dovresti ricevere una risposta simile alla seguente:

NAME                     SHORT_NAME
tagValues/123456789012   production

API

Per restituire un elenco di tutti i valori dei tag associati a una chiave, utilizza il metodo tagValues.list, con la chiave del tag principale specificata nella query:

GET https://cloudresourcemanager.googleapis.com/v3/tagValues

{
    "parent": "TAGKEY_NAME"
}

TAGKEY_NAME è il nome dell'ID permanente della chiave tag; ad esempio: tagKeys/123456789012.

Chiavi tag

Per gestire l'accesso per gli utenti a una chiave del tag:

1. Apri la pagina Tag nella console Google Cloud .

   Apri la pagina Tag

2. Nel selettore di ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene la chiave tag su cui vuoi gestire l'accesso.

3. Fai clic sulla casella di controllo accanto al tag per cui vuoi gestire l'accesso.

4. Fai clic su person Gestisci accesso.

5. Per aggiungere un ruolo a un'entità, fai clic su person_add Aggiungi entità.

   1. Nella casella di testo Nuove entità, inserisci l'indirizzo email dell'entità a cui vuoi assegnare un nuovo ruolo.

   2. Seleziona un ruolo dal menu a discesa Seleziona un ruolo. Se vuoi aggiungere più di un ruolo, fai clic su add Aggiungi un altro ruolo.

   3. Fai clic su Salva.

6. Per modificare il ruolo di un'entità, fai clic su edit Modifica accanto all'entità da modificare.

   1. Puoi modificare i ruoli assegnati ai principali in questo tag facendo clic sul menu a discesa Ruolo e scegliendo un nuovo ruolo.

   2. Se vuoi aggiungere altri ruoli, fai clic su add Aggiungi un altro ruolo.

   3. Per eliminare un ruolo da questo soggetto nella tag, fai clic su delete Elimina ruolo accanto al ruolo che vuoi eliminare.

   4. Fai clic su Salva.

7. Per eliminare il ruolo di un principal, fai clic su delete Elimina ruolo accanto al ruolo che vuoi eliminare.

   1. Fai clic su Rimuovi.

Valori tag

Per gestire l'accesso per gli utenti a un valore tag:

1. Apri la pagina Tag nella console Google Cloud .

   Apri la pagina Tag

2. Nel selettore di ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene la chiave tag per cui vuoi gestire l'accesso.

3. Fai clic su more_vert Azioni accanto alla chiave del tag per il valore per cui vuoi gestire l'accesso, quindi fai clic su Visualizza dettagli.

4. Fai clic su person Gestisci accesso.

5. Per aggiungere un ruolo a un'entità, fai clic su person_add Aggiungi entità.

   1. Nella casella di testo Nuove entità, inserisci l'indirizzo email dell'entità a cui vuoi assegnare un nuovo ruolo.

   2. Seleziona un ruolo dal menu a discesa Seleziona un ruolo. Se vuoi aggiungere più di un ruolo, fai clic su add Aggiungi un altro ruolo.

   3. Fai clic su Salva.

6. Per modificare il ruolo di un'entità, fai clic su edit Modifica accanto all'entità da modificare.

   1. Puoi modificare i ruoli assegnati ai principali in questo tag facendo clic sul menu a discesa Ruolo e scegliendo un nuovo ruolo.

   2. Se vuoi aggiungere altri ruoli, fai clic su add Aggiungi un altro ruolo.

   3. Per eliminare un ruolo da questo soggetto nella tag, fai clic su delete Elimina ruolo accanto al ruolo che vuoi eliminare.

   4. Fai clic su Salva.

7. Per eliminare il ruolo di un principal, fai clic su delete Elimina ruolo accanto al ruolo che vuoi eliminare.

   1. Fai clic su Rimuovi.

Console

Per collegare un tag a una risorsa di organizzazione, cartella o progetto, segui questi passaggi:

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

   Apri la pagina Gestisci risorse

2. Fai clic sull'organizzazione, sulla cartella o sul progetto a cui vuoi collegare un tag.

3. Fai clic su label_importantTag.

4. Nel riquadro Tag, fai clic su Seleziona ambito.

5. Seleziona l'organizzazione o il progetto che contiene i tag, quindi fai clic su Apri.

6. Nel riquadro Tag, seleziona Aggiungi tag.

7. Nel campo Chiave, seleziona la chiave del tag da allegare dall'elenco. Puoi filtrare l'elenco digitando parole chiave.

8. Nel campo Valore, seleziona il valore del tag che vuoi allegare dall'elenco. Puoi filtrare l'elenco digitando parole chiave.

9. Se vuoi allegare altri tag, fai clic su add Aggiungi tag e poi seleziona la chiave e il valore per ciascuno.

10. Fai clic su Salva.

11. Nella finestra di dialogo Conferma, fai clic su Conferma per allegare il tag.

12. Una notifica conferma l'aggiornamento dei tag. I nuovi tag vengono visualizzati nella colonna Tag della pagina Gestisci risorse.

gcloud

Per collegare un tag a una risorsa, devi creare una risorsa di associazione di tag utilizzando il comando gcloud resource-manager tags bindings create:

gcloud resource-manager tags bindings create \
--tag-value=TAGVALUE_NAME \
--parent=RESOURCE_ID \
--location=LOCATION

Dove:

• TAGVALUE_NAME è l'ID permanente o il nome con spazio dei nomi del valore tag da allegare; ad esempio: tagValues/4567890123 o 12345678/environment/production.

• RESOURCE_ID è l'ID completo della risorsa, incluso il nome di dominio dell'API per identificare il tipo di risorsa (//cloudresourcemanager.googleapis.com/). Ad esempio, per allegare un tag a projects/7890123456, l'ID completo sarebbe: //cloudresourcemanager.googleapis.com/projects/7890123456.

• LOCATION è la posizione della risorsa. Se stai allegando un tag a una risorsa globale, ad esempio una cartella o un progetto, devi omettere questo flag. Se colleghi un tag a una risorsa regionale, come un'istanza Compute Engine, devi specificare la posizione, ad esempio: us-central1.

API

Per associare un tag a una risorsa, devi prima creare una rappresentazione JSON di un'associazione di tag che includa l'ID permanente o il nome con spazio dei nomi del valore del tag e l'ID permanente della risorsa. Per ulteriori informazioni sul formato di un'associazione di tag, consulta la documentazione di riferimento di TagBinding.

Se colleghi il tag a una risorsa globale come un'organizzazione, utilizza il metodo tagBindings.create con il nome host dell'endpoint globale:

POST https://cloudresourcemanager.googleapis.com/v3/tagBindings

Se colleghi il tag a una risorsa di regione, ad esempio un'istanza Compute Engine, utilizza il metodo tagBindings.create con l'endpoint di regione in cui si trova la risorsa.

POST https://LOCATION-cloudresourcemanager.googleapis.com/v3/tagBindings

Corpo JSON della richiesta:

{
    "parent": RESOURCE_ID,
    "tagValue": TAGVALUE_NAME,
}

OPPURE

{
    "parent": RESOURCE_ID,
    "tagValueNamespacedName": TAGVALUE_NAMESPACED_NAME,
}

Dove:

• RESOURCE_ID è l'ID completo della risorsa, incluso il nome di dominio dell'API per identificare il tipo di risorsa (//cloudresourcemanager.googleapis.com/). Ad esempio, per allegare un tag a projects/7890123456, l'ID completo sarebbe: //cloudresourcemanager.googleapis.com/projects/7890123456.

• TAGVALUE_NAME è l'ID permanente del valore del tag allegato; ad esempio: tagValues/4567890123.

• TAGVALUE_NAMESPACED_NAME è il nome con spazio dei nomi del valore tag collegato e ha il formato: parentNamespace/tagKeyShortName/tagValueShortName.

Console

Per visualizzare tutti i tag collegati a una risorsa o ereditati da questa, segui questi passaggi:

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

   Apri la pagina Gestisci risorse

2. Trova la tua organizzazione, la tua cartella o il tuo progetto nell'elenco delle risorse.

3. I tag collegati alla risorsa vengono visualizzati nella colonna Tag. I tag ereditati verranno contrassegnati come lanEreditato.

gcloud

Per ottenere un elenco di associazioni di tag direttamente collegate a una risorsa, utilizza il comando gcloud resource-manager tags bindings list. Se aggiungi il flag --effective, restituirai anche un elenco di tag ereditati da questa risorsa.

gcloud resource-manager tags bindings list \
    --parent=RESOURCE_ID \
    --location=LOCATION

Dove:

• RESOURCE_ID è l'ID completo della risorsa; ad esempio: //cloudresourcemanager.googleapis.com/projects/7890123456

• LOCATION è la posizione della risorsa. Se elenca i tag collegati a una risorsa globale, ad esempio una cartella o un progetto, devi omettere questo flag. Se colleghi un tag a una risorsa di regione, ad esempio un'istanza Compute Engine, devi specificare la posizione, ad esempio us-central1.

Dovresti ricevere una risposta simile alla seguente:

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
tagValue: tagValues/567890123456
resource: //cloudresourcemanager.googleapis.com/projects/7890123456

Se aggiungi il flag --effective al comando tags bindings list, restituirai anche un elenco di tutti i tag ereditati da questa risorsa. Dovresti ricevere una risposta simile alla seguente:

namespacedTagKey: 961309089256/environment
namespacedTagValue: 961309089256/environment/production
tagKey: tagKeys/417628178507
tagValue: tagValues/247197504380
inherited: true

Se tutti i tag valutati in una risorsa sono collegati direttamente, il campo inherited è falso e viene omesso.

API

Per ottenere un elenco di associazioni di tag direttamente collegate a una risorsa globale come un'organizzazione, utilizza il metodo tagBindings.list, specificando la risorsa padre nella query:

GET https://cloudresourcemanager.googleapis.com/v3/tagBindings

{
    "parent": "RESOURCE_ID"
}

Se vuoi elencare le associazioni di tag collegate a una risorsa di regione, come le istanze Compute Engine, utilizza il metodo tagBindings.list con l'endpoint di regione in cui si trova la risorsa.

GET https://LOCATION-cloudresourcemanager.googleapis.com/v3/tagBindings

{
    "parent": "RESOURCE_ID"
}

Dove:

• RESOURCE_ID è l'ID completo della risorsa; ad esempio: //cloudresourcemanager.googleapis.com/projects/7890123456.

• LOCATION è l'endpoint di regione della risorsa, ad esempio us-central1.

In caso di esito positivo, il corpo della risposta deve includere un elenco di oggetti TagBinding. Ad esempio:

name: tagBindings/cloudresourcemanager.googleapis.com/projects/7890123456/567890123456
tagValue: tagValues/567890123456
resource: //cloudresourcemanager.googleapis.com/projects/7890123456

Console

Per scollegare un tag da una risorsa di organizzazione, cartella o progetto, segui questi passaggi:

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

   Apri la pagina Gestisci risorse

2. Fai clic sull'organizzazione, sulla cartella o sul progetto da cui vuoi scollegare un tag.

3. Fai clic su label_importantTag.

4. Nel riquadro Tag, accanto al tag da scollegare, fai clic su deleteElimina elemento.

5. Fai clic su Salva.

6. Nella finestra di dialogo Conferma, fai clic su Conferma per staccare il tag.

7. Una notifica conferma l'aggiornamento dei tag. L'elenco aggiornato dei tag viene visualizzato nella colonna Tag della pagina Gestisci risorse.

gcloud

Per eliminare un'associazione di tag, utilizza il comando gcloud resource-manager tags bindings delete:

gcloud resource-manager tags bindings delete \
--tag-value=TAGVALUE_NAME \
--parent=RESOURCE_ID \
--location=LOCATION

Dove:

• TAGVALUE_NAME è l'ID permanente o il nome con spazio dei nomi del valore del tag allegato; ad esempio: tagValues/567890123456.

• RESOURCE_ID è l'ID completo della risorsa. Ad esempio: //cloudresourcemanager.googleapis.com/projects/7890123456

• LOCATION è la posizione della risorsa. Se stai eliminando un'associazione di tag collegata a una risorsa globale, ad esempio una cartella o un progetto, devi omettere questo flag. Se elimini un'associazione di tag collegata a una risorsa di regione, ad esempio un'istanza Compute Engine, devi specificare la località, ad esempio us-central1.

API

Per eliminare un'associazione di tag collegata a una risorsa globale come un'organizzazione, utilizza il metodo tagBindings.delete:

DELETE https://cloudresourcemanager.googleapis.com/v3/{name=TAGBINDINGS_NAME}

Se vuoi eliminare un'associazione di tag collegata a una risorsa di regione, come un'istanza Compute Engine, utilizza il metodo tagBindings.delete con l'endpoint di regione in cui si trova la risorsa.

DELETE https://LOCATION-cloudresourcemanager.googleapis.com/v3/{name=TAGBINDINGS_NAME}

Dove:

• TAGBINDINGS_NAME è l'ID permanente di TagBinding; ad esempio: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F1234567890/tagValues/567890123456.

• LOCATION è l'endpoint di regione della risorsa, ad esempio us-central1.

Console

1. Nella console Google Cloud , vai alla pagina Policy dell'organizzazione.

   Vai a Policy dell'organizzazione

2. Seleziona il selettore del progetto nella parte superiore della pagina.

3. Nel selettore di progetti, seleziona l'organizzazione in cui vuoi applicare il vincolo personalizzato.

4. Configura un vincolo personalizzato con i seguenti parametri:

   • Metodo di applicazione forzata: Govern tags
   • Tipo di risorsa: il nome completo della risorsa REST Google Cloud su cui vuoi applicare i tag obbligatori, ad esempio, file.googleapis.com/Instance
   • Condizione: una condizione Common Expression Language (CEL) che specifica le chiavi tag che vuoi applicare alla risorsa, ad esempio resource.hasDirectTagKey("1234567890/owner") per applicare un binding dei tag per la chiave tag 1234567890/owner. La funzione CEL resource.hasDirectTagKey corrisponde solo ai tag applicati direttamente a una risorsa e non prende in considerazione i tag ereditati dagli antenati nella gerarchia delle risorse.
   • Azione: Allow o Deny.
     • Consenti: se la condizione specificata è soddisfatta, l'azione per creare o aggiornare la risorsa è consentita.
     • Nega: se la condizione specificata è soddisfatta, l'azione per creare o aggiornare la risorsa viene bloccata.

5. Fai clic su Crea vincolo.

gcloud

Crea un file YAML per il vincolo personalizzato:

name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resourceTypes:
- RESOURCE_NAME
methodTypes:
- GOVERN_TAGS
condition: "CONDITION"
actionType: ACTION
displayName: DISPLAY_NAME
description: DESCRIPTION

Sostituisci quanto segue:

• ORGANIZATION_ID: l'ID organizzazione, ad esempio 1234567890.

• CONSTRAINT_NAME: il nome che vuoi assegnare al nuovo vincolo personalizzato. Un vincolo personalizzato deve iniziare con custom. e può includere solo lettere maiuscole, minuscole o numeri, ad esempio custom.enforceMandatoryTags.

• RESOURCE_NAME: il nome completo della risorsa Google Cloud REST su cui vuoi applicare i tag obbligatori, ad esempio file.googleapis.com/Instance.

• CONDITION: una condizione Common Expression Language (CEL) che specifica le chiavi tag che vuoi applicare alla risorsa, ad esempio resource.hasDirectTagKey("1234567890/owner") per applicare un binding tag per la chiave tag 1234567890/owner.

• ACTION: l'azione da intraprendere se la condizione condition è soddisfatta. Può essere ALLOW o DENY.

  L'azione di negazione significa che se la condizione specificata è soddisfatta, l'operazione di creazione o aggiornamento della risorsa viene bloccata.

  L'azione Consenti significa che se la condizione specificata è soddisfatta, l'operazione per creare o aggiornare la risorsa è consentita. Ciò significa anche che tutti gli altri casi, ad eccezione di quello elencato esplicitamente nella condizione, vengono bloccati.

• DISPLAY_NAME: un nome facile da ricordare per il vincolo. Questo campo ha una lunghezza massima di 200 caratteri.

• DESCRIPTION: una descrizione comprensibile del vincolo da visualizzare come messaggio di errore in caso di violazione della policy. Questo campo ha una lunghezza massima di 2000 caratteri.

Configura il vincolo personalizzato per renderlo disponibile per le policy dell'organizzazione.

gcloud

Per creare un blocco del tag, utilizza il gcloud resource-manager tags holds create comando gcloud CLI:

  gcloud resource-manager tags holds create TAGVALUE_NAME \
  --holder=HOLDER_NAME \
  --location=LOCATION

Dove:

• TAGVALUE_NAME è l'ID permanente o il nome con spazio dei nomi del valore tag per cui deve essere creata questa sospensione del tag; ad esempio: tagValues/567890123456.

• HOLDER_NAME è il nome della risorsa a cui è collegato il valore tag. Deve contenere meno di 200 caratteri.

• LOCATION è la posizione della risorsa. Se stai creando una sospensione del tag per una risorsa globale, ad esempio un progettoGoogle Cloud , devi omettere questo flag. Se stai creando una sospensione del tag per una risorsa regionale o di zona, devi specificare la località, ad esempio us-central1.

API

Per creare una sospensione del tag per un valore del tag, devi prima creare una rappresentazione JSON di una sospensione del tag. Questo riferimento JSON deve includere un riferimento alla risorsa a cui è collegato il valore del tag. Per ulteriori informazioni sul formato di una sospensione dei tag, consulta la documentazione di riferimento di TagHolds.

Se stai creando una sospensione del tag per un valore del tag collegato a una risorsa globale come un'organizzazione, utilizza il metodo tagHolds.create con il nome host dell'endpoint globale:

POST https://cloudresourcemanager.googleapis.com/v3/tagValues/TAGVALUE_NAME/tagHolds

Se stai creando una sospensione del tag per un valore del tag collegato a una risorsa regionale, ad esempio un'istanza Compute Engine, utilizza il metodo tagHolds.create con l'endpoint di regione in cui si trova la risorsa.

POST https://LOCATION-cloudresourcemanager.googleapis.com/v3/TAGVALUE_NAME/tagHolds

Corpo JSON della richiesta:

{
    "holder":HOLDER_NAME,
    "origin":ORIGIN_NAME
}

Dove:

• TAGVALUE_NAME è l'ID permanente del valore del tag allegato; ad esempio: tagValues/4567890123.

• HOLDER_NAME è il nome della risorsa a cui è collegato il valore tag. Deve contenere meno di 200 caratteri.

• ORIGIN_NAME è una stringa facoltativa che rappresenta l'origine di questa richiesta. Questo campo deve includere informazioni comprensibili per distinguere le origini tra loro. Deve contenere meno di 200 caratteri.

gcloud

Per elencare le sospensioni dei tag che si trovano sotto un valore del tag, utilizza il gcloud resource-manager tags holds list comando gcloud CLI:

  gcloud resource-manager tags holds list TAGVALUE_NAME \
  --location=LOCATION

Dove:

• TAGVALUE_NAME è l'ID permanente o il nome con spazio dei nomi del valore del tag; ad esempio: tagValues/567890123456.

• LOCATION è la posizione della risorsa. Se stai cercando blocchi dei tag creati a livello globale, devi omettere questo flag. Se stai cercando blocchi di tag in una risorsa regionale o di zona, devi specificare la località, ad esempio us-central1.

API

Per ottenere un elenco di tag hold in base a un valore del tag, utilizza il metodo GET tagHolds specificando il valore del tag principale nell'URL:

GET https://cloudresourcemanager.googleapis.com/v3/{TAGVALUE_NAME}/tagHolds

Dove:

• TAGVALUE_NAME è l'ID permanente o il nome con spazio dei nomi del valore tag; ad esempio: tagValues/567890123456.

gcloud

Per eliminare un blocco dei tag, utilizza il comando gcloud resource-manager tags holds delete gcloud CLI:

  gcloud resource-manager tags holds delete TAGHOLD_NAME \
  --location=LOCATION

Dove:

• TAGHOLD_NAME è il nome con spazio dei nomi del blocco del tag, che può essere trovato utilizzando il comando list. Ad esempio: tagValues/1012910994523/tagHolds/d1c8f5e2-2954-43d6-8f46-5f812ab48c37.

• LOCATION è la posizione della risorsa. Se elimini un blocco tag che si trova sotto un valore tag collegato a una risorsa globale, ad esempio una cartella o un progetto, devi omettere questo flag. Se stai eliminando una sospensione del tag creata da una procedura regionale o zonale, devi specificare la località, ad esempio: us-central1.

API

Per eliminare un valore tag, utilizza il metodo tagHolds.delete:

DELETE https://cloudresourcemanager.googleapis.com/v3/{TAGVALUE_NAME}/tagHolds/{TAGHOLD_NAME}

Dove:

• TAGVALUE_NAME è l'ID permanente del valore del tag a cui è collegato il blocco del tag da eliminare; ad esempio: tagValues/567890123456.

• TAGHOLD_NAME è il nome con spazio dei nomi del blocco del tag che vuoi eliminare, che puoi trovare utilizzando il comando list. Ad esempio: tagValues/1012910994523/tagHolds/d1c8f5e2-2954-43d6-8f46-5f812ab48c37.

Console

Per eliminare un valore del tag:

1. Apri la pagina Tag nella console Google Cloud .

   Apri la pagina Tag

2. Nel selettore di ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene il valore del tag.

3. Fai clic su more_vert Azioni accanto alla chiave tag contenente il valore tag che vuoi eliminare, quindi fai clic su Visualizza dettagli.

4. Nell'elenco dei valori dei tag associati a questa chiave tag, fai clic sul valore del tag che vuoi eliminare.

5. Fai clic sulla casella di controllo accanto al valore del tag da eliminare, poi fai clic su delete Elimina valori.

6. Fai clic su Conferma.

gcloud

Per eliminare un valore del tag, utilizza il comando gcloud resource-manager tag values delete:

gcloud resource-manager tags values delete TAGVALUE_NAME

TAGVALUE_NAME è l'ID permanente o il nome con spazio dei nomi del valore tag che vuoi eliminare; ad esempio: tagValues/567890123456.

API

Per eliminare un valore tag, utilizza il metodo tagValues.delete:

DELETE https://cloudresourcemanager.googleapis.com/v3/{name=TAGVALUE_NAME}

TAGVALUE_NAME è l'ID permanente del valore del tag che vuoi eliminare; ad esempio: tagValues/567890123456.

Console

Per eliminare una chiave tag:

1. Apri la pagina Tag nella console Google Cloud .

   Apri la pagina Tag

2. Nel selettore di ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene la chiave tag.

3. Fai clic sulla casella di controllo accanto alla chiave del tag da eliminare.

4. Fai clic su delete Elimina tag.

5. Fai clic su Conferma.

gcloud

Per eliminare una chiave tag, utilizza il comando gcloud resource-manager tags keys delete:

gcloud resource-manager tags keys delete TAGKEYS_NAME

TAGKEYS_NAME è l'ID permanente o il nome con spazio dei nomi della chiave tag che vuoi eliminare; ad esempio: tagKeys/123456789012.

API

Per eliminare una chiave tag, utilizza il metodo tagKeys.delete:

DELETE https://cloudresourcemanager.googleapis.com/v3/{name=TAGKEYS_NAME}

TAGKEYS_NAME è l'ID permanente della chiave del tag che vuoi eliminare; ad esempio: tagKeys/123456789012.