Crea e gestisci i tag

Questa guida descrive come creare e gestire i tag dei workflow in Workflows. Puoi utilizzare i tag per raggruppare i workflow e altre risorse in tutta l' Google Cloud organizzazione per la generazione di report, l'audit e il controllo dell'accesso.Google Cloud

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 le policy 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 Introduzione ai tag.

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

Per raggruppare i workflow in Workflows a fini di automazione e fatturazione, utilizza le etichette. I tag e le etichette funzionano in modo indipendente e puoi applicarli entrambi allo stesso workflow. Per saperne di più sulle differenze tra tag ed etichette, consulta Tag ed etichette.

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) nelle risorse a cui sono collegati i tag
  • Visualizza e gestisci i tag a livello di organizzazione: Organization Viewer (roles/resourcemanager.organizationViewer) nell'organizzazione
  • Crea, aggiorna ed elimina le definizioni dei tag: Tag Administrator (roles/resourcemanager.tagAdmin) nella risorsa per cui stai creando, aggiornando o eliminando i tag
  • Associa e rimuovi i tag dalle risorse: Tag User (roles/resourcemanager.tagUser) nel valore del tag e nelle risorse a cui stai associando o rimuovendo il valore del tag

Per saperne di più 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 ai workflow di Workflows, devi disporre del ruolo Editor di Workflows (roles/workflows.editor).

Crea chiavi e valori dei tag

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

Aggiungi tag alle risorse esistenti

Per aggiungere un tag ai workflow esistenti:

Console

  1. Vai alla pagina Workflow nella Google Cloud console.

    2. Vai a Flussi di lavoro

  2. Seleziona il workflow a cui vuoi collegare 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 Apri.
  5. Fai clic su Aggiungi tag.
  6. Seleziona la chiave del tag che vuoi collegare dall'elenco. Puoi filtrare l'elenco digitando le parole chiave.
  7. Seleziona il valore del tag che vuoi collegare dall'elenco. Puoi filtrare l'elenco digitando le parole chiave.
  8. Fai clic su Salva.
  9. Nella finestra di dialogo Conferma, fai clic su Conferma per collegare il tag.

    10. Una notifica conferma che i tag sono stati aggiornati.

gcloud

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

      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 che colleghi a una risorsa, ad esempio tagValues/567890123456.
  • RESOURCE_ID è l'ID completo della risorsa, incluso il nome di dominio dell'API per identificare il tipo di risorsa (//workflows.googleapis.com/). Ad esempio, per collegare un tag al workflow myWorkflow in projects/workflows-test-project, nella regione us-central1, l'ID completo è: //workflows.googleapis.com/projects/workflows-test-project/locations/us-central1/workflows/myWorkflow.
  • 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 collegate direttamente o ereditate dal workflow.

Console

  1. Vai alla pagina Workflow nella Google Cloud console.

    2. Vai a Flussi di lavoro

  2. I tag vengono visualizzati nella colonna Tag del workflow.

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 (//workflows.googleapis.com/). Ad esempio, per collegare un tag al workflow myWorkflow in projects/workflows-test-project, nella regione us-central1, l'ID completo è: //workflows.googleapis.com/projects/workflows-test-project/locations/us-central1/workflows/myWorkflow.
  • 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 località, 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: //workflows.googleapis.com/projects/PROJECT_ID/locations/REGION/WORKFLOW_ID

Scollega i tag dalle risorse

Puoi scollegare i tag che sono stati collegati direttamente a un workflow. 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 Workflow nella Google Cloud console.

    2. Vai a Flussi di lavoro

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

Una notifica conferma che i tag sono stati aggiornati.

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 (//workflows.googleapis.com/). Ad esempio, per collegare un tag al workflow myWorkflow in projects/workflows-test-project, nella regione us-central1, l'ID completo è: //workflows.googleapis.com/projects/workflows-test-project/locations/us-central1/workflows/myWorkflow.
  • 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).

Elimina chiavi e valori dei tag

Quando rimuovi una definizione di chiave o valore del tag, assicurati che il tag sia scollegato dal workflow. 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 Elimina 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