# Balisage de vos ressources AWS WA Tool
Pour vous aider à gérer vos ressources AWS WA Tool, vous pouvez attribuer vos propres métadonnées à chaque ressource sous la forme de *balises*. Cette rubrique décrit les balises et vous explique comment les créer.
**Topics**
+ [Principes de base des balises](#tag-basics)
+ [Identification de vos ressources](#tag-resources)
+ [Restrictions liées aux étiquettes](#tag-restrictions)
+ [Gestion des étiquettes à l'aide de la console](#tag-resources-console)
+ [Utilisation des balises à l’aide de l’API](#tag-resources-api-sdk)
## Principes de base des balises
Une balise est une étiquette que vous affectez à une ressource AWS. Chaque balise est constituée d’une *clé* et d’une *valeur* facultative que vous définissez.
Les balises vous permettent de classer vos ressources AWS par catégorie, objectif, propriétaire ou environnement, par exemple. Lorsque vous avez de nombreuses ressources de même type, vous pouvez rapidement identifier une ressource spécifique en fonction des balises que vous lui avez attribuées. Par exemple, vous pouvez définir un ensemble de balises pour vos services AWS WA Tool afin de vous aider à suivre le propriétaire et le niveau de pile de chaque service. Nous vous recommandons de concevoir un ensemble cohérent de clés de balise pour chaque type de ressource.
Les balises ne sont pas automatiquement affectées à vos ressources. Une fois que vous avez ajouté une balise, vous pouvez modifier les clés et valeurs de balise ou supprimer les balises d'une ressource à tout moment. Si vous supprimez une ressource, ses balises sont également supprimées.
Les balises n'ont pas de signification sémantique pour AWS WA Tool et sont interprétées strictement comme des chaînes de caractères. Vous pouvez définir la valeur d’une balise sur une chaîne vide, mais vous ne pouvez pas définir la valeur d’une balise sur null. Si vous ajoutez une balise ayant la même clé qu’une balise existante sur cette ressource, la nouvelle valeur remplace l’ancienne valeur.
Vous pouvez gérer les balises à l'aide de la AWS Management Console, de l'AWS CLI et de l'API AWS WA Tool.
Si vous utilisez Gestion des identités et des accès AWS (IAM), vous pouvez contrôler quels utilisateurs de votre Compte AWS sont autorisés à créer, modifier ou supprimer des balises.
## Identification de vos ressources
Vous pouvez appliquer des balises aux ressources AWS WA Tool nouvelles ou existantes.
Si vous utilisez la console AWS WA Tool, vous pouvez appliquer des balises aux nouvelles ressources au moment de leur création ou aux ressources existantes à tout moment. Pour les charges de travail existantes, vous pouvez appliquer des balises via l’onglet **Propriétés**. Pour les objectifs personnalisés, les profils et les modèles d’examen existants, vous pouvez appliquer des balises via l’onglet **Présentation**.
Si vous utilisez l'API AWS WA Tool, l'AWS CLI ou un kit AWS SDK, vous pouvez appliquer les balises aux nouvelles ressources à l'aide du paramètre `tags` sur l'action d'API correspondante ou utiliser l'action d'API `TagResource`. Pour en savoir plus, consultez [TagResource](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html).
En outre, certaines actions de création de ressources vous permettent de spécifier des balises pour une ressource lors de la création de cette dernière. Si des balises ne peuvent pas être appliquées au cours de la création de ressources, le processus de création de ressources échoue. Cela garantit que les ressources que vous vouliez baliser lors de la création sont créées avec des balises spécifiées ou ne sont pas créées du tout. Si vous balisez des ressources au moment de la création, vous n'avez pas besoin d'exécuter de scripts de balisage personnalisés après la création des ressources.
Le tableau suivant décrit les ressources AWS WA Tool qui peuvent porter des balises, et les ressources qui peuvent porter des balises dès la création.
**Prise en charge du balisage pour les ressources AWS WA Tool**
| Ressource | Prend en charge les étiquettes | Prend en charge la propagation des étiquettes | Prend en charge le balisage au moment de la création (API AWS WA Tool, AWS CLI, kit AWS SDK) |
| --- | --- | --- | --- |
| charges de travail AWS WA Tool | Oui | Non | Oui |
| objectifs personnalisés AWS WA Tool | Oui | Non | Oui |
| AWS WA ToolProfils | Oui | Non | Oui |
| modèles d’examen AWS WA Tool | Oui | Non | Oui |
## Restrictions liées aux étiquettes
Les restrictions de base suivantes s’appliquent aux balises :
+ Nombre maximal de balises par ressource : 50
+ Pour chaque ressource, chaque clé de balise doit être unique, et chaque clé de balise peut avoir une seule valeur.
+ Longueur de clé maximale : 128 caractères Unicode en UTF-8
+ Longueur de valeur maximale : 256 caractères Unicode en UTF-8
+ Si votre schéma de balisage est utilisé pour plusieurs services et ressources AWS, n’oubliez pas que d’autres services peuvent avoir des restrictions concernant les caractères autorisés. Les caractères généralement autorisés sont les lettres, les chiffres et les espaces représentables en UTF-8, ainsi que les caractères suivants : \+ - = . \_ : / @.
+ Les clés et valeurs de balise sont sensibles à la casse.
+ N'utilisez pas `aws:`, `AWS:`, ou n'importe quelle combinaison de majuscules ou minuscules comme préfixe pour des clés ou des valeurs, car il est réservé à AWS. Vous ne pouvez pas modifier ni supprimer des clés ou valeurs d’étiquette ayant ce préfixe. Les balises avec ce préfixe ne sont pas comptabilisées comme vos balises pour la limite de ressources.
## Gestion des étiquettes à l'aide de la console
À l’aide de la console AWS WA Tool, vous pouvez gérer les balises associées aux ressources nouvelles ou existantes.
### Ajout de balises sur une ressource individuelle lors de la création
Vous pouvez ajouter des balises aux ressources AWS WA Tool lors de leur création.
### Ajout et suppression de balises sur une ressource individuelle
AWS WA Tool vous permet d’ajouter ou de supprimer des balises associées à vos ressources directement depuis l’onglet **Propriétés** pour une charge de travail, et depuis l’onglet **Présentation** pour les objectifs personnalisés, les profils et les modèles d’examen.
**Pour ajouter ou supprimer une balise sur une charge de travail**
1. Connectez-vous à la AWS Management Console et ouvrez la console de l’AWS Well-Architected Tool à l’adresse [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).
1. Dans la barre de navigation, choisissez la région à utiliser.
1. Dans le panneau de navigation, choisissez **Charges de travail**.
1. Sélectionnez la charge de travail à modifier et choisissez **Propriétés**.
1. Dans la section **Balises** choisissez **Gérer les balises**.
1. Ajoutez ou supprimez vos balises selon vos besoins.
+ Pour ajouter une balise, choisissez **Ajouter une nouvelle balise**, puis renseignez les champs **Clé** et **Valeur**.
+ Pour supprimer une balise, sélectionnez **Remove (Supprimer)**.
1. Répétez cette procédure pour chaque balise que vous voulez ajouter, modifier ou supprimer. Choisissez **Save** pour enregistrer les changements.
**Pour ajouter ou supprimer une balise sur un objectif personnalisé**
1. Connectez-vous à la AWS Management Console et ouvrez la console de l’AWS Well-Architected Tool à l’adresse [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).
1. Dans la barre de navigation, choisissez la région à utiliser.
1. Dans le volet de navigation, choisissez **Lentilles personnalisées**.
1. Sélectionnez le nom de l’objectif personnalisé à modifier.
1. Dans la section **Balises** de l’onglet **Présentation**, choisissez **Gérer les balises**.
1. Ajoutez ou supprimez vos balises selon vos besoins.
+ Pour ajouter une balise, choisissez **Ajouter une nouvelle balise**, puis renseignez les champs **Clé** et **Valeur**.
+ Pour supprimer une balise, sélectionnez **Remove (Supprimer)**.
1. Répétez cette procédure pour chaque balise que vous voulez ajouter, modifier ou supprimer. Choisissez **Save** pour enregistrer les changements.
**Pour ajouter ou supprimer une balise sur un profil**
1. Connectez-vous à la AWS Management Console et ouvrez la console de l’AWS Well-Architected Tool à l’adresse [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).
1. Dans la barre de navigation, choisissez la région à utiliser.
1. Dans le volet de navigation, choisissez **Profils**.
1. Sélectionnez le nom du profil à modifier.
1. Dans la section **Balises** de l’onglet **Présentation**, choisissez **Gérer les balises**.
1. Ajoutez ou supprimez vos balises selon vos besoins.
+ Pour ajouter une balise, choisissez **Ajouter une nouvelle balise**, puis renseignez les champs **Clé** et **Valeur**.
+ Pour supprimer une balise, sélectionnez **Remove (Supprimer)**.
1. Répétez cette procédure pour chaque balise que vous voulez ajouter, modifier ou supprimer. Choisissez **Save** pour enregistrer les changements.
**Pour ajouter ou supprimer une balise sur un modèle d’examen**
1. Connectez-vous à la AWS Management Console et ouvrez la console de l’AWS Well-Architected Tool à l’adresse [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).
1. Dans la barre de navigation, choisissez la région à utiliser.
1. Dans le volet de navigation, choisissez **Modèles d’examen**.
1. Sélectionnez le nom du modèle d’examen à modifier.
1. Dans la section **Balises** de l’onglet **Présentation**, choisissez **Gérer les balises**.
1. Ajoutez ou supprimez vos balises selon vos besoins.
+ Pour ajouter une balise, choisissez **Ajouter une nouvelle balise**, puis renseignez les champs **Clé** et **Valeur**.
+ Pour supprimer une balise, sélectionnez **Remove (Supprimer)**.
1. Répétez cette procédure pour chaque balise que vous voulez ajouter, modifier ou supprimer. Choisissez **Save** pour enregistrer les changements.
## Utilisation des balises à l’aide de l’API
Utilisez les opérations d’API AWS WA Tool pour ajouter, mettre à jour, répertorier et supprimer les balises de vos ressources.
**Prise en charge du balisage pour les ressources AWS WA Tool**
| Tâche | Action d’API |
| --- | --- |
| Ajouter ou remplacer une ou plusieurs étiquettes. | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html) |
| Supprimer une ou plusieurs étiquettes. | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_UntagResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_UntagResource.html) |
| Répertoriez les balises d’une ressource. | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ListTagsForResource.html) |
Certaines actions de création de ressources vous permettent de spécifier des étiquettes lorsque vous créez la ressource. Les actions suivantes prennent en charge l'identification lors de la création.
| Tâche | Action d’API |
| --- | --- |
| Création d’une charge de travail | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateWorkload.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateWorkload.html) |
| Importer un nouvel objectif | [ImportLens](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ImportLens.html) |
| Créer un profil | [CreateProfile](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateProfile.html) |
| Création d’un modèle d’examen | [CreateReviewTemplate](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateReviewTemplate.html) |