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.

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, les étiquettes associées à celle-ci seront é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 AWS Identity and Access Management (IAM), vous pouvez contrôler les utilisateurs autorisés à créer, modifier ou supprimer des balises. Compte AWS

Balisage de vos ressources 

Vous pouvez étiqueter des AWS WA Tool ressources nouvelles ou existantes.

Si vous utilisez la AWS WA Tool console, vous pouvez appliquer des balises aux nouvelles ressources lors 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 de révision existants, vous pouvez appliquer des balises via l'onglet Vue d'ensemble.

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 plus d'informations, consultez TagResource.

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)
AWS WA Toolcharges de travail	Oui	Non	Oui
AWS WA Toolverres personnalisés	Oui	Non	Oui
AWS WA Toolprofils	Oui	Non	Oui
AWS WA Toolmodèles d'avis	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 comportant ce préfixe ne sont pas prises en compte dans votre tags-per-resource limite.

Gestion des étiquettes à l'aide de la console

À l'aide de la AWS WA Tool console, 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 AWS WA Tool ressources lorsque vous les créez.

Ajout et suppression de balises sur une ressource individuelle

AWS WA Toolvous 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 Vue d'ensemble pour les objectifs, les profils et les modèles de révision personnalisés.

Pour ajouter ou supprimer une balise sur une charge de travail

1. Connectez-vous à la AWS Well-Architected Tool console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/wellarchitected/.

2. Dans la barre de navigation, choisissez la région à utiliser.

3. Dans le volet de navigation, sélectionnez Workloads.

4. Sélectionnez la charge de travail à modifier, puis choisissez Propriétés.

5. Dans la section Tags (Balises) choisissez Manage tags (Gérer les balises).

6. Ajoutez ou supprimez vos tags selon les besoins.

   • Pour ajouter un tag, choisissez Ajouter un nouveau tag et renseignez les champs Clé et Valeur.

   • Pour supprimer une balise, sélectionnez Remove (Supprimer).

7. Répétez ce processus pour chaque balise que vous souhaitez ajouter, modifier ou supprimer. Choisissez Save pour enregistrer les changements.

Pour ajouter ou supprimer un tag sur un objectif personnalisé

1. Connectez-vous à la AWS Well-Architected Tool console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/wellarchitected/.

2. Dans la barre de navigation, choisissez la région à utiliser.

3. Dans le volet de navigation, choisissez Verres personnalisés.

4. Sélectionnez le nom de l'objectif personnalisé à modifier.

5. Dans la section Balises de l'onglet Vue d'ensemble, choisissez Gérer les balises.

6. Ajoutez ou supprimez vos tags selon les besoins.

   • Pour ajouter un tag, choisissez Ajouter un nouveau tag et renseignez les champs Clé et Valeur.

   • Pour supprimer une balise, sélectionnez Remove (Supprimer).

7. Répétez ce processus pour chaque balise que vous souhaitez ajouter, modifier ou supprimer. Choisissez Save pour enregistrer les changements.

Pour ajouter ou supprimer un tag sur un profil

1. Connectez-vous à la AWS Well-Architected Tool console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/wellarchitected/.

2. Dans la barre de navigation, choisissez la région à utiliser.

3. Dans le volet de navigation, sélectionnez Profiles.

4. Sélectionnez le nom du profil à modifier.

5. Dans la section Balises de l'onglet Vue d'ensemble, choisissez Gérer les balises.

6. Ajoutez ou supprimez vos tags selon les besoins.

   • Pour ajouter un tag, choisissez Ajouter un nouveau tag et renseignez les champs Clé et Valeur.

   • Pour supprimer une balise, sélectionnez Remove (Supprimer).

7. Répétez ce processus pour chaque balise que vous souhaitez ajouter, modifier ou supprimer. Choisissez Save pour enregistrer les changements.

Pour ajouter ou supprimer un tag dans un modèle d'avis

1. Connectez-vous à la AWS Well-Architected Tool console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/wellarchitected/.

2. Dans la barre de navigation, choisissez la région à utiliser.

3. Dans le volet de navigation, sélectionnez Réviser les modèles.

4. Sélectionnez le nom du modèle de révision à modifier.

5. Dans la section Balises de l'onglet Vue d'ensemble, choisissez Gérer les balises.

6. Ajoutez ou supprimez vos tags selon les besoins.

   • Pour ajouter un tag, choisissez Ajouter un nouveau tag et renseignez les champs Clé et Valeur.

   • Pour supprimer une balise, sélectionnez Remove (Supprimer).

7. Répétez ce processus pour chaque balise que vous souhaitez ajouter, modifier ou supprimer. Choisissez Save pour enregistrer les changements.

Utilisation des balises à l'aide de l'API

Utilisez les opérations AWS WA Tool d'API suivantes 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.	TagResource
Supprimer une ou plusieurs étiquettes.	UntagResource
Répertorie les balises d'une ressource.	ListTagsForResource

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	CreateWorkload
Importer un nouvel objectif	ImportLens
Pour créer un profil	CreateProfile
Création d'un modèle d'avis	CreateReviewTemplate