Creazione e gestione di tag

Puoi collegare tag alle seguenti risorse router Cloud:

  • Router

Informazioni sui tag

Un tag è una coppia chiave-valore che può essere collegata a una risorsa all'interno di Google Cloud. Puoi utilizzare i tag per consentire o negare in modo condizionale i criteri a seconda che una risorsa abbia un tag specifico. Ad esempio, puoi concedere in modo condizionale i ruoli IAM (Identity and Access Management) a seconda che una risorsa abbia un tag specifico. Per saperne di più sui tag, consulta la panoramica dei tag.

I tag vengono collegati alle risorse creando una risorsa di associazione tag che collega il valore alla risorsa Google Cloud .

Autorizzazioni obbligatorie

Per ottenere le autorizzazioni necessarie per gestire i tag, chiedi all'amministratore di concederti i seguenti ruoli IAM:

  • Tag Viewer (roles/resourcemanager.tagViewer) sulle risorse a cui sono collegati i tag
  • Visualizza e gestisci i tag a livello di organizzazione: Visualizzatore organizzazione (roles/resourcemanager.organizationViewer) sull'organizzazione
  • Crea, aggiorna ed elimina le definizioni dei tag: Amministratore tag (roles/resourcemanager.tagAdmin) nella risorsa per cui stai creando, aggiornando o eliminando i tag
  • Associa e rimuovi i tag dalle risorse: Utente tag (roles/resourcemanager.tagUser) sul valore del tag e sulle risorse a cui stai associando o rimuovendo il valore del tag

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per collegare i tag alle risorse del router Cloud, devi disporre del ruolo Compute Network Admin (roles/compute.networkAdmin).

Creare chiavi e valori dei tag

Prima di poter allegare un tag, devi crearne uno e configurarne il valore. Per creare chiavi e valori tag, consulta Creazione di un tag e Aggiunta di un valore tag.

Aggiungere tag durante la creazione della risorsa

Puoi aggiungere tag al momento della creazione dei secret regionali. L'aggiunta di tag durante la creazione delle risorse consente di fornire immediatamente metadati essenziali per le risorse e aiuta anche a migliorare l'organizzazione, il monitoraggio dei costi e l'applicazione automatica dei criteri.

gcloud

Per collegare un tag a una risorsa durante la creazione, aggiungi il flag --resource-manager-tags con il rispettivo comando create. Ad esempio, per collegare un tag a un router, utilizza il seguente comando:

gcloud compute routers create ROUTER_NAME \
    --resource-manager-tags=tagKeys/TAGKEY_ID=tagValues/TAGVALUE_ID

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router
  • TAGKEY_ID: l'ID numerico del numero della chiave del tag
  • TAGVALUE_ID: l'ID numerico permanente del valore del tag allegato, ad esempio: 4567890123

Specifica più tag separandoli con una virgola, ad esempio TAGKEY1=TAGVALUE1,TAGKEY2=TAGVALUE2.

API

Invia una richiesta POST al seguente URL:

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/{region}/routers

Fornisci il seguente JSON nel corpo della richiesta:

      
    {
      "name": "ROUTER_NAME",
      "params": {
        "resourceManagerTags": {
          "tagKeys/TAGKEY_ID": "tagValues/TAGVALUE_ID",
        },
      }
      // Other fields omitted
    }

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router
  • TAGKEY_ID: l'ID numerico del numero della chiave del tag
  • TAGVALUE_ID: l'ID numerico permanente del valore del tag allegato, ad esempio: 4567890123

Aggiungere tag alle risorse esistenti

Per aggiungere un tag alle risorse router Cloud esistenti:

Console

  1. Vai alla pagina Cloud Router nella Google Cloud console.

    2. Vai a Cloud Router

  2. Seleziona la risorsa router Cloud a cui vuoi allegare un tag.
  3. Fai clic su Tag.
  4. Se la tua organizzazione non viene visualizzata nel riquadro Tag, fai clic su Seleziona ambito. Seleziona la tua organizzazione e fai clic su Apri.
  5. Fai clic su Aggiungi tag.
  6. Seleziona dall'elenco la chiave del tag che vuoi allegare. Puoi filtrare l'elenco digitando parole chiave.
  7. Seleziona dall'elenco il valore del tag che vuoi allegare. Puoi filtrare l'elenco digitando parole chiave.
  8. Fai clic su Salva.
  9. Nella finestra di dialogo Conferma, fai clic su Conferma per allegare il tag.

    10. Una notifica conferma l'aggiornamento dei tag.

gcloud

Per collegare un tag a una risorsa router Cloud, devi creare una risorsa di associazione 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

Sostituisci quanto segue:

  • 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, incluso il nome di dominio dell'API per identificare il tipo di risorsa (//compute.googleapis.com/). Devi utilizzare gli ID numerici per le risorse, non i loro nomi. Ad esempio, un ID risorsa di un router in projects/7890123456 è il seguente: //compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}
  • LOCATION: la posizione della risorsa. Se stai collegando un tag a una risorsa globale, come una cartella o un progetto, ometti questo flag. Se colleghi un tag a una risorsa regionale o di zona, devi specificare la località, ad esempio us-central1 (regione) o us-central1-a (zona).

Elenca i tag collegati alle risorse

Puoi visualizzare un elenco di associazioni di tag direttamente collegate o ereditate dalla risorsa router Cloudr.

Console

  1. Vai alla pagina Cloud Router nella Google Cloud console.

    2. Vai a Cloud Router

  2. Seleziona la risorsa per visualizzarne i dettagli. I tag vengono visualizzati nella riga Tag.

gcloud

Per ottenere un elenco di associazioni di tag collegate a una risorsa, utilizza il comando gcloud resource-manager tags bindings list:

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

Sostituisci quanto segue:

  • RESOURCE_ID: l'ID completo della risorsa, incluso il nome di dominio dell'API per identificare il tipo di risorsa (//compute.googleapis.com/). Devi utilizzare gli ID numerici per le risorse, non i loro nomi. Ad esempio, un ID risorsa di un router in projects/7890123456 è il seguente: //compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}
  • LOCATION: la posizione della risorsa. Se stai visualizzando un tag collegato a una risorsa globale, ad esempio una cartella o un progetto, ometti questo flag. Se visualizzi un tag collegato a una risorsa regionale o di zona, devi specificare la posizione, ad esempio us-central1 (regione) o us-central1-a (zona).

Dovresti ricevere una risposta simile alla seguente:

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: 
//compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}

Scollegare i tag dalle risorse

Puoi scollegare i tag collegati direttamente a una risorsa router Cloud. I tag ereditati possono essere sostituiti collegando un tag con la stessa chiave e un valore diverso, ma non possono essere scollegati.

Console

  1. Vai alla pagina Cloud Router nella Google Cloud console.

    2. Vai a Cloud Router

  2. Seleziona la risorsa router Cloud da cui vuoi rimuovere un tag.
  3. Fai clic su Tag.
  4. Nel riquadro Tag, accanto al tag da scollegare, fai clic su Elimina elemento.
  5. Fai clic su Salva.
  6. Nella finestra di dialogo Conferma, fai clic su Conferma per staccare il tag.

Una notifica conferma l'aggiornamento dei tag.

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

Sostituisci quanto segue:

  • 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, incluso il nome di dominio dell'API per identificare il tipo di risorsa (//compute.googleapis.com/). Devi utilizzare gli ID numerici per le risorse, non i loro nomi. Ad esempio, un ID risorsa di un router in projects/7890123456 è il seguente: //compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}
  • LOCATION: la posizione della risorsa. Se stai collegando un tag a una risorsa globale, come una cartella o un progetto, ometti questo flag. Se colleghi un tag a una risorsa regionale o di zona, devi specificare la località, ad esempio us-central1 (regione) o us-central1-a (zona).

Eliminare chiavi e valori dei tag

Quando rimuovi una definizione di chiave o valore del tag, assicurati che il tag sia scollegato dalla risorsa router Cloud. Prima di eliminare la definizione del tag, devi eliminare gli allegati esistenti, chiamati associazioni di tag. Per eliminare chiavi tag e valori tag, consulta la sezione Eliminare i tag.

Condizioni e tag di Identity and Access Management

Puoi utilizzare i tag e le condizioni IAM per concedere in modo condizionale le associazioni di ruoli agli utenti della gerarchia. La modifica o l'eliminazione del tag associato a una risorsa può rimuovere l'accesso utente a quella risorsa se è stata applicata una policy IAM con associazioni di ruoli condizionali. Per maggiori informazioni, consulta Condizioni e tag di Identity and Access Management.

Passaggi successivi