Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Tag : espaces de travail Grafana gérés par Amazon
Utilisez les procédures décrites dans cette section pour utiliser les balises des espaces de travail Amazon Managed Grafana.
**Topics**
# Ajout d’une balise à un espace de travail
L'ajout de balises (paires clé-valeur) à un espace de travail Amazon Managed Grafana peut vous aider à identifier et à organiser vos ressources. AWS Tout d'abord, vous ajoutez une ou plusieurs balises à un espace de travail, puis vous pouvez créer des politiques IAM pour gérer l'accès à l'espace de travail en fonction de ces balises. Vous pouvez utiliser la console ou la AWS CLI pour ajouter des balises à un espace de travail Amazon Managed Grafana.
**Important**
L’ajout de balises à un espace de travail peut avoir un impact sur l’accès à cet espace de travail. Avant d’ajouter une balise à un espace de travail, assurez-vous de passer en revue toutes les politiques IAM qui peuvent utiliser des balises pour contrôler l’accès aux ressources.
Pour plus d'informations sur l'ajout de balises à un espace de travail Amazon Managed Grafana lors de sa création, consultez le guide de l'utilisateur d'[Création d'un espace de travail Grafana géré par Amazon](AMG-create-workspace.md)Amazon Managed Grafana.
------
#### [ Console ]
Vous pouvez utiliser la console pour ajouter une ou plusieurs balises à un espace de travail Amazon Managed Grafana.
1. Ouvrez la console Amazon Managed Grafana à l'adresse. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/)
1. Dans le volet de navigation de gauche, choisissez l'icône du menu.
1. Choisissez **Tous les espaces de travail.**
1. Choisissez l’ID de l’espace de travail que vous voulez gérer.
1. Sélectionnez l’onglet **Tags** (Identifications).
1. Choisissez **Gérer les balises**.
1. Dans le champ **Clé**, entrez le nom du tag. Vous pouvez ajouter une valeur facultative pour le tag dans le champ **Valeur**.
1. (Facultatif) Pour ajouter un autre tag, choisissez **Ajouter un tag**.
1. Une fois les balises ajoutées, choisissez **Enregistrer les modifications**.
------
#### [ CLI ]
Suivez ces étapes pour utiliser la AWS CLI afin d'ajouter une ou plusieurs balises à un espace de travail Amazon Managed Grafana :
+ Sur le terminal ou sur la ligne de commande, exécutez la `tag-resource` commande en spécifiant le nom de ressource Amazon (ARN) de l'espace de travail dans lequel vous souhaitez ajouter des balises, ainsi que la clé et la valeur de la balise que vous souhaitez ajouter. Vous pouvez ajouter plusieurs balises à un espace de travail. Par exemple, pour étiqueter l'espace de travail Grafana *My-Workspace* avec une clé de balise nommée *Name* avec la valeur de balise de*my\$1key\$1value*, exécutez la commande suivante :
```
aws grafana tag-resource --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/My-Workspace --tags "Name=my_key_value"
```
------
# Visualisation des balises d’un espace de travail
Vous pouvez consulter les balises associées à un espace de travail Grafana géré par Amazon. Pour plus d'informations sur les stratégies de balisage, consultez la section [AWS Ressources de balisage](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) dans la section Référence AWS générale.
------
#### [ Console ]
Vous pouvez utiliser la console pour afficher les balises associées à un espace de travail Amazon Managed Grafana.
1. Ouvrez la console Amazon Managed Grafana à l'adresse. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/)
1. Dans le volet de navigation de gauche, choisissez l'icône du menu.
1. Sélectionnez **All workspaces**.
1. Choisissez l’ID de l’espace de travail que vous voulez gérer.
1. Sélectionnez l’onglet **Tags** (Identifications).
------
#### [ CLI ]
Procédez comme suit pour utiliser la AWS CLI afin d'afficher les AWS balises d'un Amazon Managed Grafana espace de travail. Si aucune balise n’a été ajoutée, la liste renvoyée est vide.
Depuis le terminal ou la ligne de commande, exécutez la commande **list-tags-for-resource**. Par exemple, pour afficher la liste des clés de balise et des valeurs de balise pour un espace de travail, exécutez la commande suivante :
```
aws grafana list-tags-for-resource --resoure-arn arn:aws:grafana:us-west-2:/workspace/workspace-IDstring
```
Si elle aboutit, cette commande renvoie des informations similaires à ce qui suit :
```
{
"tags": {
"Status": "Secret",
"Team": "My-Team"
}
}
```
------
# Modification des balises d’un espace de travail
Vous pouvez modifier la valeur d'une balise associée à un espace de travail en un seul appel à l'aide de l'`TagResource`API. Pour mettre à jour la clé d'une balise existante, vous devez combiner le `UntagResource` et `TagResource` APIs.
**Important**
La modification des balises d'un espace de travail Grafana géré par Amazon peut avoir un impact sur l'accès à cet espace de travail. Avant de modifier une balise pour un espace de travail, assurez-vous de passer en revue les politiques IAM susceptibles d'utiliser la clé ou la valeur d'une balise pour contrôler l'accès aux ressources telles que les référentiels.
------
#### [ Console ]
Vous pouvez utiliser la console pour modifier les balises associées à l'espace de travail Amazon Managed Grafana.
1. [Ouvrez la console Amazon Managed Grafana sur Grafana Console.](https://console.aws.amazon.com/grafana/)
1. Dans le volet de navigation de gauche, choisissez l'icône du menu.
1. Sélectionnez **All workspaces**.
1. Choisissez l’ID de l’espace de travail que vous voulez gérer.
1. Sélectionnez l’onglet **Tags** (Identifications).
1. Choisissez **Gérer les balises**.
1. Dans le champ **Clé**, entrez le nom du tag. Vous pouvez ajouter une valeur facultative pour le tag dans le champ de **valeur**.
1. Lorsque vous avez terminé de modifier les balises, choisissez **Enregistrer les modifications**.
------
#### [ CLI ]
Procédez comme suit pour utiliser le AWS CLI pour mettre à jour une balise pour un espace de travail. Vous pouvez modifier la valeur d'une clé existante ou en ajouter une autre.
Sur le terminal ou sur la ligne de commande, exécutez la commande **tag-resource** en spécifiant le nom de ressource Amazon (ARN) de l'espace de travail Amazon Managed Grafana dans lequel vous souhaitez mettre à jour une balise et spécifiez la clé et la valeur de la balise.
Par exemple, pour modifier la valeur d'une balise par une nouvelle valeur*Key\$1value\$1new*, exécutez la commande suivante.
```
aws grafana tag-resource \
--resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/workspace-IDstring \
--tags "Name=Key_value_new"
```
Pour changer le nom de la clé d'une balise*Name\$1new*, exécutez les commandes suivantes :
```
aws grafana untag-resource --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/workspace-IDstring --tag-keys Items=Name
aws grafana tag-resource --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/workspace-IDstring --tags "Name_new=Key_value_old"
```
------
# Suppression d’une balise d’un espace de travail
Vous pouvez supprimer une ou plusieurs balises associées à un espace de travail. La suppression d'un tag ne supprime pas le tag des autres AWS ressources associées à ce tag.
**Important**
La suppression de balises d'un espace de travail Grafana géré par Amazon peut avoir un impact sur l'accès à cet espace de travail. Avant de supprimer une balise d'un espace de travail, assurez-vous de consulter les politiques IAM susceptibles d'utiliser la clé ou la valeur d'une balise pour contrôler l'accès à des ressources telles que les espaces de travail.
------
#### [ Console ]
Vous pouvez utiliser la console pour supprimer l’association entre une balise et un espace de travail.
1. [Ouvrez la console Amazon Managed Grafana sur Grafana Console.](https://console.aws.amazon.com/grafana/)
1. Dans le volet de navigation de gauche, choisissez l'icône du menu.
1. Sélectionnez **All workspaces**.
1. Choisissez l’ID de l’espace de travail que vous voulez gérer.
1. Sélectionnez l’onglet **Tags** (Identifications).
1. Choisissez **Gérer les balises**.
1. Recherchez le tag que vous souhaitez supprimer, puis choisissez **Supprimer**.
1. Lorsque vous avez fini de supprimer les balises, choisissez **Enregistrer les modifications**.
------
#### [ CLI ]
Procédez comme suit pour utiliser le AWS CLI pour supprimer une étiquette d'un espace de travail. La suppression d'une balise ne supprime pas la balise des autres ressources, mais elle supprime simplement l'association entre la balise et l'espace de travail.
**Note**
Si vous supprimez un espace de travail Grafana géré par Amazon, toutes les associations de balises sont supprimées de l'espace de travail supprimé. Vous n’avez pas besoin de supprimer les balises avant de supprimer un espace de travail.
Sur le terminal ou sur la ligne de commande, exécutez la commande **untag-resource** en spécifiant le nom de ressource Amazon (ARN) de l'espace de travail dans lequel vous souhaitez supprimer les balises et la clé de balise de la balise que vous souhaitez supprimer. Par exemple, pour supprimer une balise sur un espace de travail nommé *workspace-IDstring* avec la clé de balise*Name*, exécutez la commande suivante :
```
aws grafana untag-resource --resoure-arn arn:aws:grafana:us-west-2:/workspaces/workspace-IDstring --tag-keys Items=Name
```
En cas de succès, cette commande renvoie une réponse vide. Pour vérifier que les balises associées à l'espace de travail ont été supprimées, exécutez la **list-tags-for-resource**commande.
------