Créer et gérer des tags

Ce guide explique comment créer et gérer des tags de workflow dans Workflows. Vous pouvez utiliser des tags pour regrouper des workflows et d'autres ressources dans Google Cloud afin de générer des rapports, d'effectuer des audits et de contrôle des accès dans votre organisationGoogle Cloud .

À propos des tags

Un tag est une paire clé-valeur qui peut être associée à une ressource dansGoogle Cloud. Vous pouvez utiliser des tags pour autoriser ou refuser de manière conditionnelle les règles selon qu'une ressource dispose ou non d'un tag spécifique. Par exemple, vous pouvez attribuer des rôles IAM (Identity and Access Management) de manière conditionnelle selon qu'une ressource est associée à un tag spécifique. Pour en savoir plus sur les tags, consultez la page Présentation des tags.

Les tags sont associés à des ressources en créant une ressource de liaison de tag qui associe la valeur à la ressource Google Cloud .

Pour regrouper des workflows dans Workflows à des fins d'automatisation et de facturation, utilisez des étiquettes. Les tags et les libellés fonctionnent indépendamment les uns des autres. Vous pouvez appliquer les deux au même workflow. Pour en savoir plus sur les différences entre les tags et les libellés, consultez Tags et libellés.

Autorisations requises

Pour obtenir les autorisations nécessaires pour gérer les tags, demandez à votre administrateur de vous accorder les rôles IAM suivants :

• Lecteur de tags (roles/resourcemanager.tagViewer) sur les ressources auxquelles les tags sont associés
• Afficher et gérer les tags au niveau de l'organisation : Lecteur de l'organisation (roles/resourcemanager.organizationViewer) sur l'organisation
• Créer, mettre à jour et supprimer des définitions de tags : Administrateur de tags (roles/resourcemanager.tagAdmin) sur la ressource pour laquelle vous créez, mettez à jour ou supprimez des tags
• Associer et dissocier des tags à des ressources : Utilisateur de tags (roles/resourcemanager.tagUser) sur la valeur de tag et les ressources auxquelles vous associez ou dissociez la valeur de tag

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour associer des tags à des workflows Workflows, vous devez disposer du rôle Éditeur de workflows (roles/workflows.editor).

Créer des clés et des valeurs de tags

Avant de pouvoir associer un tag, vous devez d'abord créer un tag et configurer sa valeur. Pour créer des clés et des valeurs de tags, consultez les sections Créer un tag et Ajouter une valeur de tag.

Ajouter des tags à des ressources existantes

Pour ajouter un tag à des workflows existants, procédez comme suit :

Console

1. Accédez à la page Workflows de la console Google Cloud .

Accéder à "Workflows"

2. Sélectionnez le workflow auquel vous souhaitez associer un tag.
3. Cliquez sur Tags.
4. Si votre organisation n'apparaît pas dans le panneau Tags, cliquez sur Sélectionner un niveau d'accès. Sélectionnez votre organisation, puis cliquez sur Ouvrir.
5. Cliquez sur Ajouter un tag.
6. Dans la liste, sélectionnez la clé du tag que vous souhaitez associer. Vous pouvez filtrer la liste en saisissant des mots clés.
7. Dans la liste, sélectionnez la valeur du tag que vous souhaitez associer. Vous pouvez filtrer la liste en saisissant des mots clés.
8. Cliquez sur Enregistrer.
9. Dans la boîte de dialogue Confirmer, cliquez sur Confirmer pour associer le tag.

Une notification confirme que vos tags ont été mis à jour.

gcloud

Pour associer un tag à un workflow, vous devez créer une ressource de liaison de tag à l'aide de la commande gcloud resource-manager tags bindings create :

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

Remplacez les éléments suivants :

• TAGVALUE_NAME : ID permanent ou nom d'espace de noms de la valeur de tag associée. Par exemple, tagValues/567890123456.
• RESOURCE_ID est l'ID complet de la ressource, avec le nom de domaine de l'API permettant de déterminer le type de ressource (//workflows.googleapis.com/). Par exemple, pour associer un tag au workflow myWorkflow dans projects/workflows-test-project, dans la région us-central1, l'ID complet est le suivant : //workflows.googleapis.com/projects/workflows-test-project/locations/us-central1/workflows/myWorkflow.
• LOCATION : emplacement de votre ressource. Si vous associez un tag à une ressource globale, par exemple un dossier ou un projet, omettez ce flag. Si vous associez un tag à une ressource régionale ou zonale, vous devez spécifier l'emplacement, par exemple us-central1 (région) ou us-central1-a (zone).

Répertorier les tags associés aux ressources

Vous pouvez afficher une liste de liaisons de tags directement associées au workflow ou dont celui-ci a hérité.

Console

1. Accédez à la page Workflows de la console Google Cloud .

Accéder à "Workflows"

2. Les tags sont affichés dans la colonne Tags du workflow.

gcloud

Pour obtenir la liste des liaisons de tags associées à une ressource, exécutez la commande gcloud resource-manager tags bindings list :

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

Remplacez les éléments suivants :

• RESOURCE_ID est l'ID complet de la ressource, avec le nom de domaine de l'API permettant de déterminer le type de ressource (//workflows.googleapis.com/). Par exemple, pour associer un tag au workflow myWorkflow dans projects/workflows-test-project, dans la région us-central1, l'ID complet est le suivant : //workflows.googleapis.com/projects/workflows-test-project/locations/us-central1/workflows/myWorkflow.
• LOCATION : emplacement de votre ressource. Si vous affichez un tag associé à une ressource globale, telle qu'un dossier ou un projet, omettez ce flag. Si vous affichez un tag associé à une ressource régionale ou zonale, vous devez spécifier l'emplacement, par exemple us-central1 (région) ou us-central1-a (zone).

Vous devriez obtenir un résultat semblable à celui-ci :

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: //workflows.googleapis.com/projects/PROJECT_ID/locations/REGION/WORKFLOW_ID
      

Dissocier les tags des ressources

Vous pouvez dissocier les tags qui ont été directement associés à un workflow. Les tags hérités peuvent être remplacés en associant un tag ayant la même clé et une valeur différente, mais ils ne peuvent pas être dissociés.

Console

1. Accédez à la page Workflows de la console Google Cloud .

Accéder à "Workflows"

2. Sélectionnez le workflow dont vous souhaitez supprimer un tag.
3. Cliquez sur Tags.
4. Dans le panneau Tags, à côté du tag que vous souhaitez dissocier, cliquez sur Supprimer l'élément.
5. Cliquez sur Enregistrer.
6. Dans la boîte de dialogue Confirmer, cliquez sur Confirmer pour dissocier le tag.

Une notification confirme que vos tags ont été mis à jour.

gcloud

Pour supprimer une liaison de tag, exécutez la commande gcloud resource-manager tags bindings delete :

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

Remplacez les éléments suivants :

• TAGVALUE_NAME : ID permanent ou nom d'espace de noms de la valeur de tag associée. Par exemple, tagValues/567890123456.
• RESOURCE_ID est l'ID complet de la ressource, avec le nom de domaine de l'API permettant de déterminer le type de ressource (//workflows.googleapis.com/). Par exemple, pour associer un tag au workflow myWorkflow dans projects/workflows-test-project, dans la région us-central1, l'ID complet est le suivant : //workflows.googleapis.com/projects/workflows-test-project/locations/us-central1/workflows/myWorkflow.
• LOCATION : emplacement de votre ressource. Si vous associez un tag à une ressource globale, par exemple un dossier ou un projet, omettez ce flag. Si vous associez un tag à une ressource régionale ou zonale, vous devez spécifier l'emplacement, par exemple us-central1 (région) ou us-central1-a (zone).

Supprimer des clés et des valeurs de tags

Lorsque vous supprimez une clé ou une définition de valeur de tag, assurez-vous que le tag est dissocié du workflow. Vous devez supprimer les rattachements de tag existants, appelés liaisons de tags, avant de supprimer la définition de tag elle-même. Pour supprimer des clés et des valeurs de tags, consultez la section Supprimer des tags.

Conditions et tags Identity and Access Management

Vous pouvez utiliser des tags et des conditions IAM pour attribuer des liaisons de rôles de manière conditionnelle aux utilisateurs dans votre hiérarchie. La modification ou la suppression du tag associé à une ressource peut supprimer l'accès des utilisateurs à cette ressource, si une stratégie IAM avec des liaisons de rôle conditionnelles a été appliquée. Pour en savoir plus, consultez la section Conditions et tags Identity and Access Management.

Étapes suivantes

• Consultez les autres services compatibles avec les tags.
• Consultez la section Tags et contrôle des accès pour apprendre à utiliser les tags avec IAM.