Gérer les tags pour les ressources

Console

Selon le type de ressource, les étapes exactes peuvent varier. Par exemple, les étapes suivantes permettent d'associer un tag à une VM :

1. Dans la console Trusted Cloud , accédez à la page Instances de VM.

   Accéder à la page Instances de VM

2. Sélectionnez le projet et cliquez sur Continuer.

3. Dans la colonne Nom, cliquez sur le nom de la VM à laquelle vous souhaitez ajouter des tags.

4. Sur la page des détails de l'instance de VM, procédez comme suit :

   1. Cliquez sur Modifier.
   2. Dans la section Informations de base, cliquez sur Gérer les tags et ajoutez les tags souhaités pour l'instance.
   3. Cliquez sur Enregistrer.

gcloud

Pour savoir comment utiliser ces indicateurs, consultez la section Associer des tags aux ressources dans la documentation Resource Manager.

Par exemple, la commande suivante associe un tag à une VM :

gcloud resource-manager tags bindings create \
    --location LOCATION_NAME \
    --tag-value=tagValues/TAGVALUE_ID \
    --parent=//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID

Remplacez les éléments suivants :

• LOCATION_NAME : région contenant la ressource cible (dans cet exemple, la région de l'instance de VM)
• TAGVALUE_ID : ID numérique de la valeur de tag
• PROJECT_NUMBER : ID numérique du projet contenant la ressource cible.
• ZONE : zone contenant la ressource cible (dans cet exemple, la zone de l'instance de VM)
• VM_ID : ID de l'instance de VM

REST

Pour associer un tag à une ressource, vous devez d'abord créer une représentation JSON d'une liaison de tag incluant l'ID permanent ou le nom de l'espace de noms de la valeur de tag et l'ID permanent de la ressource. Pour en savoir plus sur le format d'une liaison de tag, consultez la documentation de référence sur les liaisons de tag.

Pour associer le tag à une ressource zonale, telle qu'une instance de VM, utilisez la méthode tagBindings.create avec le point de terminaison régional où se trouve votre ressource. Exemple :

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

Le corps de la requête peut être l'une des deux options suivantes :

{
  "parent": "//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID",
  "tagValue": "tagValue/TAGVALUE_ID"
}

{
  "parent": "//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID",
  "tagValueNamespacedName": TAGVALUE_NAMESPACED_NAME
}

Remplacez les éléments suivants :

• LOCATION_NAME : région contenant la ressource cible (dans cet exemple, la région de l'instance de VM)
• PROJECT_NUMBER : ID numérique du projet contenant la ressource cible.
• ZONE : zone contenant la ressource cible (dans cet exemple, la zone de l'instance de VM)
• VM_ID : ID de l'instance de VM
• TAGVALUE_ID : ID permanent de la valeur de tag associée (par exemple, 4567890123)
• TAGVALUE_NAMESPACED_NAME : nom de l'espace de noms de la valeur de tag associée, au format suivant : parentNamespace/tagKeyShortName/tagValueShortName

Console

Selon le type de ressource, les étapes exactes peuvent varier. Les étapes suivantes concernent une VM :

1. Dans la console Trusted Cloud , accédez à la page Instances de VM.

   Accéder à la page Instances de VM

2. Sélectionnez le projet et cliquez sur Continuer.

3. Cliquez sur Créer une instance. La page Créer une instance s'affiche et le volet Configuration de la machine s'ouvre.

4. Dans le menu de navigation, cliquez sur Avancé. Dans le volet Avancé qui s'affiche, procédez comme suit :

   1. Développez la section expand_moreGérer les tags et les libellés.
   2. Cliquez sur addAjouter des tags.
   3. Dans le volet Tags qui s'ouvre, suivez les instructions pour ajouter un tag à l'instance.
   4. Cliquez sur Enregistrer.

5. Spécifiez d'autres options de configuration pour votre instance. Pour en savoir plus, consultez Options de configuration lors de la création d'une instance.

6. Pour créer et démarrer la VM, cliquez sur Créer.

gcloud

Pour associer un tag à une ressource lors de la création de la ressource, ajoutez l'option --resource-manager-tags avec la commande create correspondante. Par exemple, pour associer un tag à une VM, utilisez la commande suivante :

  gcloud compute instances create INSTANCE_NAME \
      --zone=ZONE \
      --resource-manager-tags=tagKeys/TAGKEY_ID=tagValues/TAGVALUE_ID

Remplacez les éléments suivants :

• INSTANCE_NAME : nom de votre instance de VM
• ZONE : zone contenant l'instance de VM
• TAGKEY_ID : ID numérique du numéro de clé de tag
• TAGVALUE_ID : ID numérique permanent de la valeur de tag associée (par exemple, 4567890123)

Spécifiez plusieurs tags en les séparant par une virgule, par exemple, TAGKEY1=TAGVALUE1,TAGKEY2=TAGVALUE2.

REST

Envoyez une requête POST à l'URL suivante :

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances

Incluez le corps JSON de la requête suivante :

{
  "name": INSTANCE_NAME,
  "params": {
    "resourceManagerTags": {
      "tagKeys/TAGKEY_ID": "tagValues/TAGVALUE_ID",
    },
  }
  // other fields omitted
}

Remplacez les éléments suivants :

• INSTANCE_NAME : nom de votre instance de VM
• TAGKEY_ID : ID numérique du numéro de clé de tag
• TAGVALUE_ID : ID numérique permanent de la valeur de tag associée (par exemple, 4567890123)

Console

Selon le type de ressource, les étapes exactes peuvent être légèrement différentes. Par exemple, les étapes suivantes dissocient un tag d'une VM :

1. Dans la console Trusted Cloud , accédez à la page Instances de VM.

   Accéder à la page Instances de VM

2. Sélectionnez le projet et cliquez sur Continuer.

3. Dans la colonne Nom, cliquez sur le nom de l'instance pour laquelle vous souhaitez supprimer des tags.

4. Sur la page des détails de l'instance de VM, procédez comme suit :

   1. Cliquez sur Modifier.
   2. Pour les tags Resource Manager, dans la section Informations de base, cliquez sur Gérer les tags. Supprimez les tags que vous souhaitez pour l'instance. Vous ne pouvez supprimer que les tags qui ont été directement ajoutés à l'instance.
   3. Pour les tags réseau, dans la section Mise en réseau, supprimez le tag de la liste Tags réseau.
   4. Cliquez sur Enregistrer.

gcloud

Pour dissocier un tag d'une instance de calcul, utilisez la commande resource-manager tags bindings delete :

gcloud resource-manager tags bindings delete \
    --location LOCATION_NAME \
    --tag-value=tagValues/TAGVALUE_ID \
    --parent //compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/INSTANCE_ID

Remplacez les éléments suivants :

• LOCATION_NAME : zone de la ressource cible, par exemple us-central1-a
• TAGVALUE_ID : ID numérique de la clé de tag
• PROJECT_NUMBER : ID numérique du projet contenant la ressource cible.
• ZONE : nom de la zone, tel que us-central1-a
• INSTANCE_ID : ID numérique de l'instance de calcul

Pour mettre à jour ou remplacer une liaison de tag existante, dissociez l'ancienne liaison et associez la nouvelle.

REST

Pour supprimer une liaison de tag associée à une ressource, telle qu'une instance de calcul, utilisez la méthode tagBindings.delete avec le point de terminaison régional où se trouve votre ressource.

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

Remplacez les éléments suivants :

• LOCATION : point de terminaison régional de votre ressource (par exemple, us-central1)
• TAGBINDINGS_NAME : ID permanent de TagBinding. Par exemple, tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F1234567890/tagValues/567890123456.

Console

Selon le type de ressource, les étapes exactes peuvent être légèrement différentes. Par exemple, les étapes suivantes montrent comment afficher les tags d'une VM :

1. Dans la console Trusted Cloud , accédez à la page Instances de VM.

   Accéder à la page Instances de VM

2. Sélectionnez le projet et cliquez sur Continuer.

3. Dans la colonne Nom, cliquez sur le nom de la VM pour laquelle vous souhaitez afficher les tags.

4. Sur la page des détails de l'instance de VM, recherchez les tags dans la section Tags.

gcloud

Pour obtenir la liste des liaisons de tags directement associées à une ressource, exécutez la commande gcloud resource-manager tags bindings list. Si vous ajoutez l'option --effective, vous renverrez également une liste de tags hérités par cette ressource. Exemple :

gcloud resource-manager tags bindings list \
    --location=LOCATION_NAME \
    --parent //compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID

Remplacez les éléments suivants :

• LOCATION_NAME : zone de la ressource cible, par exemple us-central1-a
• PROJECT_NUMBER : ID numérique du projet contenant la ressource cible.
• ZONE : nom de la zone, tel que us-central1-a
• VM_ID : ID numérique de l'instance de VM

Si vous ajoutez l'option --effective à la commande tags bindings list, vous obtiendrez également la liste de tous les tags hérités par cette ressource.

Le résultat ressemble à ce qui suit :

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

Si tous les tags évalués sur une ressource sont directement associés, le champ inherited est "false" et est omis.

REST

Si vous souhaitez répertorier les liaisons de tags associées à une ressource régionale telle qu'une instance Compute Engine, utilisez la méthode tagBindings.list avec le point de terminaison régional où se trouve votre ressource. Exemple :

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

{
    "parent": "//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/VM_ID"
}

Remplacez les éléments suivants :

• LOCATION_NAME : région de la ressource cible, telle que us-central1
• PROJECT_NUMBER : ID numérique du projet contenant la ressource cible.
• ZONE : nom de la zone, tel que us-central1-a
• VM_ID : ID numérique de l'instance de VM