Questa guida descrive come creare e gestire i tag. Un tag è una coppia chiave-valore che può essere collegata a una risorsa Google Cloud. Puoi utilizzare i tag per consentire o negare in modo condizionale i criteri a seconda che una risorsa supportata abbia un tag specifico.
Prima di iniziare
Per ulteriori informazioni su cosa sono i tag e sul loro funzionamento, consulta la Panoramica dei tag.
Autorizzazioni obbligatorie
Le autorizzazioni necessarie dipendono dall'azione che devi eseguire.
Per ottenere queste autorizzazioni, chiedi all'amministratore di concedere il ruolo suggerito al livello appropriato della gerarchia delle risorse.
Visualizza tag
Per visualizzare le definizioni dei tag e i tag collegati alle risorse, devi disporre del ruolo Visualizzatore tag (roles/resourcemanager.tagViewer
) o di un altro ruolo che includa le seguenti autorizzazioni:
Autorizzazioni obbligatorie
resourcemanager.tagKeys.get
resourcemanager.tagKeys.list
resourcemanager.tagValues.list
resourcemanager.tagValues.get
listTagBindings
per il tipo di risorsa appropriato. Ad esempio,compute.instances.listTagBindings
per visualizzare i tag associati alle istanze di Compute Engine.listEffectiveTags
per il tipo di risorsa appropriato.
Ad esempio,
compute.instances.listEffectiveTags
per visualizzare tutti i tag collegati o ereditati dalle istanze di Compute Engine.
Per visualizzare i tag a livello di organizzazione, devi disporre del ruolo Visualizzatore organizzazione (roles/resourcemanager.organizationViewer
) nella risorsa organizzazione.
Amministrazione dei tag
Per creare, aggiornare ed eliminare le definizioni dei tag, devi disporre del ruolo Amministratore tag (roles/resourcemanager.tagAdmin
) o di un altro ruolo che includa le seguenti autorizzazioni:
Autorizzazioni obbligatorie
resourcemanager.tagKeys.create
resourcemanager.tagKeys.update
resourcemanager.tagKeys.delete
resourcemanager.tagKeys.list
resourcemanager.tagKeys.get
resourcemanager.tagKeys.getIamPolicy
resourcemanager.tagKeys.setIamPolicy
resourcemanager.tagValues.create
resourcemanager.tagValues.update
resourcemanager.tagValues.delete
resourcemanager.tagValues.list
resourcemanager.tagValues.get
resourcemanager.tagValues.getIamPolicy
resourcemanager.tagValues.setIamPolicy
Per amministrare i tag a livello di organizzazione, devi disporre del ruolo Visualizzatore organizzazione (roles/resourcemanager.organizationViewer
) nella risorsa organizzazione.
Gestisci i tag sulle risorse
Per aggiungere e rimuovere i tag collegati alle risorse, devi disporre del ruolo Utente tag (roles/resourcemanager.tagUser
) o di un altro ruolo con autorizzazioni equivalenti, sia per il valore tag sia per le risorse a cui stai collegando il valore tag. Il ruolo Utente tag include le seguenti autorizzazioni:
Autorizzazioni obbligatorie
- Autorizzazioni richieste per la risorsa a cui stai collegando il valore tag
- Autorizzazione
createTagBinding
specifica della risorsa, ad esempiocompute.instances.createTagBinding
per le istanze di Compute Engine. - Autorizzazione
deleteTagBinding
specifica della risorsa, ad esempiocompute.instances.deleteTagBinding
per le istanze di Compute Engine. - Autorizzazioni richieste per il valore tag:
resourcemanager.tagValueBindings.create
resourcemanager.tagValueBindings.delete
- Autorizzazioni che consentono di visualizzare i progetti e le definizioni dei tag:
resourcemanager.tagValues.get
resourcemanager.tagValues.list
resourcemanager.tagKeys.get
resourcemanager.tagKeys.list
resourcemanager.projects.get
Creazione e definizione di un nuovo tag
I tag sono costituiti da una coppia chiave-valore e sono collegati a una risorsa nella gerarchia di Google Cloud. Per creare un nuovo tag, devi prima creare una chiave tag che descriva il tag che stai creando. Ad esempio, potresti voler specificare gli ambienti di produzione, test e sviluppo per le risorse nella gerarchia delle risorse creando una chiave con il nome environment
.
Quindi, puoi creare i diversi valori che la chiave può avere. Se hai creato una chiave tag denominata environment
, ti consigliamo di specificare che esistono tre potenziali ambienti e creare un valore per ciascuno: production
, development
e test
.
Puoi creare un massimo di 1000 chiavi create in un'organizzazione o un progetto specifico e un totale di 1000 valori creati per ogni chiave.
Infine, puoi collegare questi valori alle risorse nella gerarchia, che porta con sé anche l'associazione della coppia chiave-valore. Ad esempio, potresti
associare test
a più cartelle dell'ambiente di test
della tua organizzazione, ciascuna delle quali contiene la coppia chiave-valore environment: test
.
Creazione di un tag
Per iniziare, devi creare una chiave tag.
Il campo shortName
della chiave tag può avere una lunghezza massima di 256 caratteri. Il set di caratteri consentito per shortName
include caratteri Unicode codificati in UTF-8, tranne le virgolette singole ('
), le virgolette doppie ("
e le barre rovesciate (\`),
and forward slashes (
/").
Una volta creato, shortName
non può essere modificato e deve essere univoco all'interno dello stesso spazio dei nomi.
Console
Per creare una chiave tag:
Apri la pagina Tag nella console Google Cloud.
Dal selettore dell'ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto in cui vuoi creare una chiave tag.
Fai clic su
Crea.Nella casella Chiave tag, inserisci il nome visualizzato della chiave tag. Questo diventa parte del nome con spazio dei nomi del tag.
Nella casella Descrizione chiave tag, inserisci una descrizione della chiave tag.
Se vuoi aggiungere valori tag a questa chiave, fai clic su
Aggiungi valore per ogni valore tag da creare.Nella casella Valore tag, inserisci il nome visualizzato del valore del tag. Questo diventa parte del nome con spazio dei nomi del tag.
Nella casella Descrizione valore tag, inserisci una descrizione del valore del tag.
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 per la chiave tag, ad esempio:environment
.RESOURCE_ID
è l'ID dell'organizzazione o della risorsa di progetto padre per questa chiave tag, ad esempio:organizations/123456789012
,projects/test-project123
oprojects/234567890123
. Per scoprire come ottenere l'ID organizzazione, consulta Creazione e gestione delle organizzazioni. Per scoprire come ottenere l'ID progetto, consulta 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
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 TagKey.
Quindi, utilizza il metodo tagKeys.create:
POST https://cloudresourcemanager.googleapis.com/v3/tagKeys/ -d
Corpo JSON richiesta:
{ "parent": RESOURCE_ID, "shortName": SHORT_NAME, "description": DESCRIPTION, }
Dove:
SHORT_NAME
è il nome visualizzato per la chiave tag, ad esempio:environment
.RESOURCE_ID
è l'ID dell'organizzazione o della risorsa di progetto padre per questa chiave tag, ad esempio:organizations/123456789012
,projects/test-project123
oprojects/234567890123
. Per scoprire come ottenere l'ID organizzazione, consulta Creazione e gestione delle organizzazioni. Per scoprire come ottenere l'ID progetto, consulta Creazione e gestione dei progetti.DESCRIPTION
è una descrizione della chiave di massimo 256 caratteri.
Dopo aver creato la chiave, puoi trovare il nome visualizzato univoco leggibile namespacedName
, con uno spazio dei nomi all'interno della risorsa padre, e un ID permanente univoco a livello globale denominato name
.
Visualizzazione di una chiave tag
Puoi trovare informazioni su una determinata chiave tag utilizzando l'ID permanente o il nome con spazio dei nomi visualizzato al momento della creazione.
Console
Per visualizzare un tag creato:
Apri la pagina Tag nella console Google Cloud.
Dal selettore dell'ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto contenente il tag.
Nell'elenco vengono visualizzati tutti i tag nell'organizzazione o nel progetto selezionato. Fai clic sul tag di 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 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 tag per la quale vuoi visualizzare le informazioni, ad esempio: tagKeys/123456789012
.
Per visualizzare le informazioni relative a una determinata chiave 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 ed è nel formato parentNamespace/tagKeyShortName
.
Aggiungere valori tag
Dopo aver creato una chiave tag, puoi aggiungere i valori accettati per la chiave.
L'shortName
del valore del tag deve soddisfare i seguenti requisiti:
Un
shortName
può avere una lunghezza massima di 256 caratteri.Un
shortName
deve iniziare con un carattere alfanumerico.Un
shortName
può contenere caratteri Unicode con codifica UTF-8, ad eccezione delle virgolette singole ('
), delle virgolette doppie ("
e delle barre rovesciate (\`), and forward slashes (
/).Una volta creato,
shortName
non può essere modificato e deve essere univoco all'interno dello stesso spazio dei nomi.
Console
Per creare un valore tag, procedi nel seguente modo:
Apri la pagina Tag nella console Google Cloud.
Dal selettore dell'ambito nella parte superiore della pagina, scegli l'organizzazione o il progetto in cui vuoi creare un valore di tag.
Nell'elenco dei tag, fai clic sul tag a cui aggiungere un nuovo valore.
Fai clic su
Aggiungi valore.Nella casella Valore tag, inserisci il nome visualizzato del valore del tag. Questo diventa parte del nome con spazio dei nomi del tag.
Nella casella Descrizione valore tag, inserisci una descrizione del valore del tag.
Fai clic su Salva.
gcloud
Per creare un valore tag, utilizza il comando gcloud resource-manager tags values
create
. Devi specificare la chiave con 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 del tag, ad esempio:production
.TAGKEY_NAME
è l'ID permanente o il nome con spazio dei nomi della chiave del 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
API
Per creare un valore tag, crea una rappresentazione JSON del valore. Per ulteriori informazioni sul formato di un valore tag, consulta il riferimento TagValue.
Poi, utilizza il metodo tagValues.create:
POST https://cloudresourcemanager.googleapis.com/v3/tagValues/ -d
Corpo JSON richiesta:
{ "parent": TAGKEY_NAME, "shortName": SHORT_NAME, "description": DESCRIPTION, }
Dove:
TAGKEY_NAME
è l'ID permanente della chiave del tag principale, ad esempio:tagKeys/4567890123
.SHORT_NAME
è il nome visualizzato per il valore del tag, ad esempio:environment
.DESCRIPTION
è una descrizione del valore di massimo 256 caratteri. Dopo aver creato il valore, puoi trovare il nome visualizzato univoco leggibile chiamatonamespacedName
, con spazio dei nomi all'interno della risorsa padre, e un ID permanente univoco a livello globale chiamatoname
.
Recupero valori tag
Puoi trovare informazioni su un determinato valore di tag utilizzando l'ID permanente o il nome con spazio dei nomi visualizzato al momento della creazione.
Console
Per visualizzare un tag creato:
Apri la pagina Tag nella console Google Cloud.
Dal selettore dell'ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto contenente il tag.
Tutti i tag creati in questa organizzazione o progetto vengono visualizzati nell'elenco. Fai clic sul tag di cui vuoi visualizzare i valori.
gcloud
Per visualizzare le informazioni relative a un determinato valore di 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 di 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 tag utilizzando il 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 del tag ed è nel formato parentNamespace/tagKeyShortName/tagValueShortName
.
Quando fai riferimento ai tag con Google Cloud CLI, puoi utilizzare il nome con spazio dei nomi o l'ID permanente per le chiavi e i valori dei tag. Le chiamate all'API
tranne getNamespaced
devono utilizzare solo l'ID permanente. Per ulteriori informazioni sui tipi di identificatori utilizzati da un tag, consulta Definizioni e identificatori dei tag.
Aggiornamento dei tag esistenti
Puoi modificare un tag esistente aggiornando la chiave o i valori associati. Puoi aggiornare la descrizione di un tag, ma non il nome breve.
Console
Per aggiornare la descrizione di una chiave tag:
Apri la pagina Tag nella console Google Cloud.
Dal selettore dell'ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene la chiave tag.
Fai clic su
Azioni accanto alla chiave tag da aggiornare, quindi fai clic su Visualizza dettagli.Fai clic su
Modifica accanto a Descrizione nella parte superiore dello schermo.Aggiorna la descrizione della chiave tag.
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 richiesta:
{ "description": DESCRIPTION, }
Dove:
TAGKEY_NAME
è l'ID permanente della chiave tag, ad esempio:tagKeys/123456789012
.DESCRIPTION
è una descrizione della chiave di massimo 256 caratteri.
Puoi anche modificare la descrizione dei valori dei tag.
Console
Per aggiornare la descrizione di un valore tag:
Apri la pagina Tag nella console Google Cloud.
Dal selettore dell'ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene il valore del tag.
Fai clic su
Azioni accanto alla chiave tag per il valore da aggiornare, poi fai clic su Visualizza dettagli.Fai clic su
Azioni accanto al valore del tag da aggiornare, poi fai clic su Visualizza dettagli.Fai clic su
Modifica accanto a Descrizione nella parte superiore dello schermo.Aggiorna la descrizione del valore del tag.
Fai clic su Salva.
gcloud
Per modificare la descrizione del valore di un 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 richiesta:
{ "description": DESCRIPTION, }
Dove:
TAGVALUE_NAME
è il nome ID permanente del valore tag, ad esempio:tagValues/4567890123
.DESCRIPTION
è una descrizione della chiave di massimo 256 caratteri.
Elenco delle chiavi tag
Puoi elencare tutte le chiavi tag associate a una particolare organizzazione o risorsa di progetto utilizzando la console Google Cloud, gcloud CLI o una chiamata all'API.
Console
Per visualizzare tutti i tag:
Apri la pagina Tag nella console Google Cloud.
Dal selettore dell'ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene i tag.
Tutti i tag creati in questa organizzazione o progetto vengono visualizzati nell'elenco.
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 dell'organizzazione o della risorsa del progetto per cui vuoi trovare le chiavi tag associate.
- L'ID organizzazione o progetto deve essere indicato nel formato
organizations/ORGANIZATION_ID
oprojects/PROJECT_NAME
, ad esempioorganizations/123456789012
eprojects/test-project123
. Per scoprire come ottenere l'ID organizzazione, consulta Creazione e gestione delle organizzazioni. Per scoprire come ottenere l'ID progetto, consulta 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 dell'organizzazione o della risorsa del progetto per cui vuoi trovare chiavi tag associate, ad esempio: organizations/123456789012
e projects/test-project123
.
Elenca valori tag
Puoi elencare tutti i valori di tag associati a una determinata chiave tag utilizzando la console Google Cloud, gcloud CLI o una chiamata all'API.
Console
Per visualizzare tutti i valori tag associati a una chiave tag:
Apri la pagina Tag nella console Google Cloud.
Dal selettore dell'ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto contenente la chiave tag.
Fai clic su
Azioni accanto alla chiave tag contenente i valori tag da trovare, poi fai clic su Visualizza dettagli.Tutti i valori tag creati in questa chiave tag vengono visualizzati nell'elenco.
gcloud
Per restituire un elenco di tutti i valori dei tag associati 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 associati, 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 tag associati a una chiave, utilizza il metodo tagValues.list, con la chiave tag principale specificata nella query:
GET https://cloudresourcemanager.googleapis.com/v3/tagValues { "parent": "TAGKEY_NAME" }
TAGKEY_NAME
è il nome ID permanente della chiave tag, ad esempio: tagKeys/123456789012
.
Gestione dell'accesso ai tag
Puoi concedere agli utenti un accesso specifico per gestire i tag e collegare i valori dei tag alle risorse utilizzando la console Google Cloud. Consulta Autorizzazioni richieste per un elenco dei ruoli relativi ai tag e le autorizzazioni che contengono.
Chiavi tag
Per gestire l'accesso degli utenti a una chiave tag:
Apri la pagina Tag nella console Google Cloud.
Dal selettore dell'ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto contenente la chiave tag per la quale vuoi gestire l'accesso.
Fai clic sulla casella di controllo accanto al tag per il quale vuoi gestire l'accesso.
Fai clic su
Gestisci accesso.Per aggiungere un ruolo a un'entità, fai clic su
Aggiungi entità.Nella casella di testo Nuove entità, inserisci l'indirizzo email dell'entità a cui vuoi concedere un nuovo ruolo.
Seleziona un ruolo dal menu a discesa Seleziona un ruolo. Se vuoi aggiungere più di un ruolo, fai clic su
Aggiungi un altro ruolo.Fai clic su Salva.
Per modificare il ruolo di un'entità, fai clic su
Modifica accanto all'entità da modificare.Puoi modificare i ruoli assegnati alle entità in questo tag facendo clic sul menu a discesa Ruolo e scegliendo un nuovo ruolo.
Se vuoi aggiungere altri ruoli, fai clic su
Aggiungi un altro ruolo.Per eliminare un ruolo da questa entità su questo tag, fai clic su
Elimina ruolo accanto al ruolo che vuoi eliminare.Fai clic su Salva.
Per eliminare il ruolo di un'entità, fai clic su
Elimina ruolo accanto al ruolo che vuoi eliminare.- Fai clic su Rimuovi.
Valori tag
Per gestire l'accesso degli utenti a un valore tag:
Apri la pagina Tag nella console Google Cloud.
Dal selettore dell'ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene la chiave tag per cui vuoi gestire l'accesso.
Fai clic su
Azioni accanto alla chiave tag per il valore per il quale vuoi gestire l'accesso, poi fai clic su Visualizza dettagli.Fai clic su
Gestisci accesso.Per aggiungere un ruolo a un'entità, fai clic su
Aggiungi entità.Nella casella di testo Nuove entità, inserisci l'indirizzo email dell'entità a cui vuoi concedere un nuovo ruolo.
Seleziona un ruolo dal menu a discesa Seleziona un ruolo. Se vuoi aggiungere più di un ruolo, fai clic su
Aggiungi un altro ruolo.Fai clic su Salva.
Per modificare il ruolo di un'entità, fai clic su
Modifica accanto all'entità da modificare.Puoi modificare i ruoli assegnati alle entità in questo tag facendo clic sul menu a discesa Ruolo e scegliendo un nuovo ruolo.
Se vuoi aggiungere altri ruoli, fai clic su
Aggiungi un altro ruolo.Per eliminare un ruolo da questa entità su questo tag, fai clic su
Elimina ruolo accanto al ruolo che vuoi eliminare.Fai clic su Salva.
Per eliminare il ruolo di un'entità, fai clic su
Elimina ruolo accanto al ruolo che vuoi eliminare.- Fai clic su Rimuovi.
Collegamento di tag alle risorse
Dopo la creazione di un tag e l'accesso adeguato sia al tag sia alla risorsa, il tag può essere associato a una risorsa Google Cloud come coppia chiave-valore. È possibile associare esattamente un valore a una risorsa per una determinata chiave. Ad esempio, se è allegato environment: development
, non è possibile collegare environment: production
o environment: test
.
A ogni risorsa possono essere collegate un massimo di 50 coppie chiave-valore.
I tag vengono collegati alle risorse creando una risorsa di associazione di tag che collega il valore alla risorsa Google Cloud. Il flusso di lavoro seguente descrive come associare un tag a un'organizzazione, una cartella o una risorsa di progetto. Per maggiori dettagli su come collegare i tag a un altro tipo di risorsa, consulta la documentazione relativa alla risorsa in Servizi che supportano i tag.
Console
Per collegare un tag a un'organizzazione, una cartella o una risorsa di progetto, segui questi passaggi:
Apri la pagina Gestisci risorse nella console Google Cloud.
Fai clic sull'organizzazione, sulla cartella o sul progetto a cui vuoi associare un tag.
Fai clic su
Tag.Nel riquadro Tag, fai clic su Seleziona ambito.
Seleziona l'organizzazione o il progetto che contiene i tag, quindi fai clic su Apri.
Nel riquadro Tag, seleziona Aggiungi tag.
Nel campo Chiave, seleziona dall'elenco la chiave del tag che vuoi collegare. Puoi filtrare l'elenco digitando parole chiave.
Nel campo Valore, seleziona dall'elenco il valore del tag che vuoi collegare. Puoi filtrare l'elenco digitando parole chiave.
Se vuoi collegare altri tag, fai clic su
Aggiungi tag, poi seleziona la chiave e il valore per ciascuno.Fai clic su Salva.
Nella finestra di dialogo Conferma, fai clic su Conferma per allegare il tag.
Una notifica conferma l'aggiornamento dei tag. I nuovi tag vengono visualizzati nella colonna Tag della pagina Gestione 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 associare, ad esempio:tagValues/4567890123
o12345678/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 collegare un tag aprojects/7890123456
, l'ID completo sarebbe://cloudresourcemanager.googleapis.com/projects/7890123456
.LOCATION
è la località della risorsa. Se colleghi un tag a una risorsa globale, come una cartella o un progetto, devi omettere questo flag. Se colleghi un tag a una risorsa di regione, come un'istanza di Compute Engine, devi specificare la località, ad esempious-central1
.
API
Per collegare 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 su 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 di Compute Engine, utilizza il metodo tagBindings.create
con l'endpoint a livello di regione in cui si trova la risorsa.
POST https://LOCATION-cloudresourcemanager.googleapis.com/v3/tagBindings
Corpo JSON 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 collegare un tag aprojects/7890123456
, l'ID completo sarebbe://cloudresourcemanager.googleapis.com/projects/7890123456
.TAGVALUE_NAME
è l'ID permanente del valore tag associato, ad esempio:tagValues/4567890123
.TAGVALUE_NAMESPACED_NAME
è il nome con spazio dei nomi del valore tag associato ed è nel formato:parentNamespace/tagKeyShortName/tagValueShortName
.
Elenco di tutti i tag associati a una risorsa
Puoi ottenere un elenco di tutti i tag associati a una risorsa, per i tag ereditati o collegati direttamente.
Console
Per visualizzare tutti i tag collegati a una risorsa o ereditati da una risorsa, procedi nel seguente modo:
Apri la pagina Gestisci risorse nella console Google Cloud.
Trova l'organizzazione, la cartella o il progetto nell'elenco delle risorse.
I tag associati alla risorsa vengono visualizzati nella colonna Tag. I tag ereditati verranno contrassegnati come
ereditati.
gcloud
Per ottenere un elenco delle associazioni di tag direttamente collegate a una risorsa, utilizza il comando gcloud resource-manager tags bindings list
. Se aggiungi il flag --effective
, restituirà 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 località della risorsa. Se elenchi i tag associati a una risorsa globale, ad esempio una cartella o un progetto, devi omettere questo flag. Se colleghi un tag a una risorsa di una regione, come un'istanza di Compute Engine, devi specificare la località, ad esempious-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
, restituirà 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 su una risorsa sono collegati direttamente, il campo inherited
è falso e viene omesso.
API
Per ottenere un elenco delle associazioni di tag collegate direttamente 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, ad esempio le istanze di Compute Engine, utilizza il metodo tagBindings.list
con l'endpoint a livello 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 a livello di regione per la 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
Scollegamento di un tag da una risorsa
Puoi scollegare un tag da una risorsa eliminando la risorsa di associazione di tag.
Console
Per scollegare un tag da un'organizzazione, una cartella o una risorsa di progetto, segui questi passaggi:
Apri la pagina Gestisci risorse nella console Google Cloud.
Fai clic sull'organizzazione, sulla cartella o sul progetto da cui vuoi scollegare un tag.
Fai clic su
Tag.Nel riquadro Tag, accanto al tag che vuoi scollegare, fai clic su
Elimina elemento.Fai clic su Salva.
Nella finestra di dialogo Conferma, fai clic su Conferma per scollegare il tag.
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 tag associato; ad esempio:tagValues/567890123456
.RESOURCE_ID
è l'ID completo della risorsa. Ad esempio://cloudresourcemanager.googleapis.com/projects/7890123456
LOCATION
è la località 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 stai eliminando un'associazione di tag collegata a una risorsa di regione, ad esempio un'istanza di Compute Engine, devi specificare la località, ad esempious-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, ad esempio un'istanza di Compute Engine, utilizza il metodo tagBindings.delete
con l'endpoint a livello 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 a livello di regione per la risorsa; ad esempio:us-central1
.
Protezione dei valori dei tag con blocchi dei tag
Un blocco dei tag è una risorsa che puoi creare per impedire l'eliminazione di un valore tag. Se un valore tag presenta un blocco dei tag, non può essere eliminato dagli utenti a meno che il blocco dei tag non venga prima eliminato.
Creazione di archiviazioni a fini legali nei tag
Puoi creare manualmente un blocco tag utilizzando gcloud CLI o l'API.
gcloud
Per creare un blocco dei tag, utilizza il comando gcloud resource-manager tags holds create
dellgcloud 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 del tag per cui deve essere creata questa conservazione tag, ad esempio:tagValues/567890123456
.HOLDER_NAME
è il nome della risorsa a cui è associato il valore del tag. Deve contenere meno di 200 caratteri.LOCATION
è la località della risorsa. Se stai creando un blocco dei tag per una risorsa globale, ad esempio un progetto Google Cloud, devi omettere questo flag. Se crei un blocco dei tag per una risorsa di regione o zona, devi specificare la località, ad esempious-central1
.
API
Per creare un blocco tag per un valore tag, devi prima creare una rappresentazione JSON di una conservazione tag. Questo riferimento JSON deve includere un riferimento alla risorsa a cui è associato il valore tag. Per ulteriori informazioni sul formato di un blocco dei tag, consulta il riferimento TagHolds
.
Se stai creando un blocco tag per un valore tag associato a una risorsa globale, ad esempio 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 un blocco tag per un valore tag associato a una risorsa di regione, ad esempio un'istanza di Compute Engine, utilizza il metodo tagHolds.create
con l'endpoint a livello di regione in cui si trova la risorsa.
POST https://LOCATION-cloudresourcemanager.googleapis.com/v3/TAGVALUE_NAME/tagHolds
Corpo JSON richiesta:
{ "holder":HOLDER_NAME, "origin":ORIGIN_NAME }
Dove:
TAGVALUE_NAME
è l'ID permanente del valore tag associato, ad esempio:tagValues/4567890123
.HOLDER_NAME
è il nome della risorsa a cui è associato il valore del 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 l'una dall'altra. Deve contenere meno di 200 caratteri.
Archiviazioni a fini legali dei tag della scheda
Puoi elencare tutte le archiviazioni a fini legali sotto un determinato valore di tag utilizzando gcloud CLI o l'API.
gcloud
Per elencare le archiviazioni a fini legali dei tag che si trovano sotto un valore di tag, utilizza il comando gcloud resource-manager tags holds list
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 località della risorsa. Se stai cercando archiviazioni a fini legali dei tag create a livello globale, devi omettere questo flag. Se cerchi blocchi dei tag in una risorsa di regione o zona, devi specificare la località, ad esempio:us-central1
.
API
Per ottenere un elenco delle archiviazioni a fini legali sotto un valore 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 del tag, ad esempio:tagValues/567890123456
.
Rimozione delle archiviazioni a fini legali nei tag
Puoi rimuovere le archiviazioni a fini legali dei tag create su un determinato valore di tag utilizzando gcloud CLI o l'API.
Alcune risorse aggiungono blocchi tag a un valore tag associato a tale risorsa. Se colleghi un tag a una risorsa di questo tipo, quest'ultima crea un blocco tag che impedisce agli utenti di eliminare il valore del tag associato.
Puoi eliminare un blocco dei tag utilizzando gcloud CLI o l'API.
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 puoi trovare utilizzando il comandolist
. Ad esempio:tagValues/1012910994523/tagHolds/d1c8f5e2-2954-43d6-8f46-5f812ab48c37
.LOCATION
è la località della risorsa. Se stai eliminando un blocco di tag che si trova sotto un valore tag associato a una risorsa globale, ad esempio una cartella o un progetto, devi omettere questo flag. Se stai eliminando un blocco di tag creato da un processo a livello di regione o zona, devi specificare la località, ad esempio:us-central1
.
API
Per eliminare un valore di 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 tag a cui è associata la conservazione del tag da eliminare, ad esempio:tagValues/567890123456
.TAGHOLD_NAME
è il nome con spazio dei nomi del blocco del tag da eliminare, che puoi trovare utilizzando il comandolist
. Ad esempio:tagValues/1012910994523/tagHolds/d1c8f5e2-2954-43d6-8f46-5f812ab48c37
.
Eliminazione dei tag in corso...
Per eliminare un tag, devi eliminare tutti i componenti che lo definiscono. Innanzitutto, devi eliminare tutte le associazioni di tag che associano questo tag alle risorse nella tua gerarchia. Per istruzioni sull'eliminazione delle associazioni di tag, consulta Scollegare un tag da una risorsa.
Se il tag viene utilizzato da un'altra risorsa o se un utente ha creato manualmente un blocco dei tag, potrebbe essere necessario rimuovere le archiviazioni a fini legali e le associazioni di tag prima di poter eliminare i valori dei tag. Per informazioni sulla rimozione delle sospensioni dei tag, consulta Rimozione delle sospensioni dei tag.
Quando non ci sono più associazioni di tag per i valori di tag da eliminare, puoi eliminare i valori.
Console
Per eliminare il valore di un tag:
Apri la pagina Tag nella console Google Cloud.
Dal selettore dell'ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene il valore del tag.
Fai clic su
Azioni accanto alla chiave tag contenente il valore tag da eliminare, quindi fai clic su Visualizza dettagli.Nell'elenco dei valori tag associati a questa chiave tag, fai clic sul valore tag che desideri eliminare.
Fai clic sulla casella di controllo accanto al valore di tag da eliminare, poi fai clic su
Elimina valori.Fai clic su Conferma.
gcloud
Per eliminare un valore di 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 il valore di un tag, utilizza il metodo tagValues.delete:
DELETE https://cloudresourcemanager.googleapis.com/v3/{name=TAGVALUE_NAME}
TAGVALUE_NAME
è l'ID permanente del valore
tag che vuoi eliminare; ad esempio: tagValues/567890123456
.
Dopo aver eliminato tutti i valori tag associati a una chiave, puoi eliminare la chiave.
Console
Per eliminare una chiave tag:
Apri la pagina Tag nella console Google Cloud.
Dal selettore dell'ambito nella parte superiore della pagina, seleziona l'organizzazione o il progetto che contiene la chiave tag.
Fai clic sulla casella di controllo accanto alla chiave tag da eliminare.
Fai clic su
Elimina tag.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 da 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 tag da eliminare, ad esempio: tagKeys/123456789012
.
Criteri e tag
Puoi utilizzare i tag con criteri che li supportano per applicarli in modo condizionale. Puoi impostare la presenza o l'assenza di un valore di tag come condizione per tale criterio.
Ad esempio, puoi concedere in modo condizionale i ruoli IAM (Identity and Access Management) a seconda che una risorsa abbia un tag specifico.
Condizioni e tag di Identity and Access Management
Puoi utilizzare i tag e le condizioni di Identity and Access Management per concedere i ruoli agli utenti nella gerarchia in modo condizionale. Questo processo rende le risorse inaccessibili agli utenti finché non viene collegato un tag associato a un criterio condizionale. Ad esempio, potresti richiedere agli sviluppatori di assegnare un centro di costo a una risorsa prima di poterla utilizzare.
Crea un tag che puoi utilizzare per associare le risorse a qualcosa che identificherà se alle risorse è stata applicata la governance appropriata. Ad esempio, potresti creare un tag con la chiave
costCenter
e i valori0001
,0002
e così via per associare le risorse ai vari centri di costo della tua azienda.Crea un ruolo personalizzato a livello di organizzazione che consenta agli utenti di aggiungere tag alle risorse per le quali richiedi i tag. In questo modo concedi queste autorizzazioni alle entità specificate in qualsiasi punto dell'organizzazione.
Ad esempio, un ruolo personalizzato che consente agli utenti di aggiungere tag ai progetti include le seguenti autorizzazioni:
resourcemanager.projects.get
resourcemanager.hierarchyNodes.create
resourcemanager.hierarchyNodes.delete
resourcemanager.hierarchyNodes.list
Quando crei progetti per gli sviluppatori, assegna loro questo ruolo personalizzato.
Assegna agli sviluppatori eventuali altri ruoli che includano le autorizzazioni necessarie per eseguire le azioni desiderate all'interno del progetto. Quando concedi ruoli agli utenti del progetto, questi devono essere sempre concessi in modo condizionale per richiedere il collegamento del tag
costCenter
.resource.hasTagKey('123456789012/costCenter')
Ora, ogni volta che viene creato un progetto, i tuoi sviluppatori devono collegare il tag costCenter
prima di poter eseguire al suo interno le azioni concesse dal criterio IAM.
Criteri e tag dell'organizzazione
Puoi utilizzare i tag e l'applicazione condizionale dei criteri dell'organizzazione per fornire un controllo centralizzato delle risorse nella gerarchia. Per maggiori informazioni, consulta Impostare un criterio dell'organizzazione con i tag.
Servizi supportati
Per un elenco dei servizi che supportano i tag, consulta Servizi che supportano i tag.
Risoluzione dei problemi noti
L'espressione della condizione non riesce
Se esegui uno dei comandi add-iam-policy-binding
utilizzando Google Cloud CLI e il criterio IAM su quella risorsa contiene associazioni di ruoli condizionali per quel ruolo, lo strumento gcloud CLI ti chiede di scegliere una delle espressioni di condizione esistenti nel criterio. Se scegli un'espressione di condizione che contiene una virgola, il comando non andrà a buon fine. Per risolvere questo problema, utilizza il flag --condition
per specificare un'espressione della condizione nella riga di comando.