Balises

Important

Le AWS OpsWorks Stacks service a atteint sa fin de vie le 26 mai 2024 et a été désactivé tant pour les nouveaux clients que pour les clients existants. Nous recommandons vivement aux clients de migrer leurs charges de travail vers d'autres solutions dès que possible. Si vous avez des questions sur la migration, contactez l' AWS Support équipe sur AWS Re:Post ou via le AWS Support Premium.

Les balises peuvent vous aider à regrouper des ressources dans des piles Chef 11.10, Chef 12 et Chef 12.2, et suivre les coûts d'utilisation de ces ressources dans AWS Billing and Cost Management.

Vous pouvez appliquer des balises au niveau de la pile et de la couche. Lorsque vous créez une balise, vous appliquez la balise à chaque ressource au sein de la structure balisée. Par exemple, si vous appliquez une balise à une couche, vous l'appliquez à chaque instance, à chaque volume Amazon EBS (sauf la racine) ou à chaque équilibreur de charge Elastic Load Balancing de la couche. Les balises ne peuvent pas actuellement être appliquées au volume racine, ou volume EBS par défaut, d'une instance.

Les balises sont des paires clé-valeur que vous attribuez à des piles ou à des couches dans Stacks. AWS OpsWorks Après avoir créé des balises, ouvrez la console Billing and Cost Management pour activer les balises définies par l'utilisateur. Pour plus d'informations sur la façon d'activer vos tags et de les utiliser pour suivre et gérer les coûts de vos ressources AWS OpsWorks Stacks, consultez les sections Utilisation des balises de répartition des coûts et activation des balises de répartition des coûts définies par l'utilisateur dans le guide de l'utilisateur de Billing and Cost Management.

Les balises fonctionnent de la même manière que les attributs personnalisés dans AWS OpsWorks Stacks. Les balises que vous appliquez à une pile sont héritées par chaque couche de la pile. Au niveau de la couche, vous pouvez remplacer les valeurs (mais pas les noms de clé) des balises héritées et ajouter de nouvelles balises spécifiques à la couche. AWS OpsWorks applique le jeu de balises obtenu à toutes les ressources de la couche. A mesure que vous créez de nouvelles ressources ou attribuez des ressources existantes à une couche, les nouvelles ressources de la couche sont balisées avec le même ensemble de balises.

Configuration des balises au niveau de la pile

Au niveau de la pile, vous pouvez ajouter et gérer des balises en choisissant Balises sur la page d'accueil de la pile.

Sur la page Balises, ajoutez des balises sous forme de paires clé-valeur. La capture d'écran suivante montre des exemples de balises. Vous pouvez supprimer des balises en sélectionnant le X rouge à droite d'une paire clé-valeur.

Configuration des balises au niveau d'une couche

Au niveau d'une couche, définissez des balises en choisissant l'onglet Balises. Vous pouvez trouver cet onglet sur la page d'accueil Layers (Couches) et la page d'accueil de chaque couche.

Lorsque vous modifiez ou ajoutez des balises au niveau d'une couche, gardez à l'esprit que les balises qui ont été ajoutées au niveau de la pile parent sont héritées par la couche et ses ressources. Si vous pouvez modifier les valeurs de balises héritées, vous ne pouvez pas modifier les noms de clé, ou supprimer des balises héritées. Modifiez les noms de clé ou supprimez les balises héritées de la pile parent dans les paramètres de la pile. La capture d'écran suivante montre des exemples de balises héritées du niveau de la pile. Les balises héritées sont grisées.

Pour plus d'informations sur l'ajout de balises à des piles, consultez Créer une pile. Pour plus d'informations sur l'ajout de balises à des couches, consultez Modification de OpsWorks la configuration d'une couche.

Gérer les tags à l'aide du AWS CLI

Vous pouvez également utiliser des AWS CLI commandes pour ajouter et supprimer des balises au niveau de la pile et de la couche. Pour plus d'informations sur le téléchargement et l'installation du AWS CLI, voir Installation de l'interface de ligne de AWS commande. N'oubliez pas d'ajouter le paramètre --region à votre commande si la pile que vous voulez baliser n'est pas dans votre région par défaut. Les ARN des couches n'apparaissent pas actuellement dans le AWS Management Console. Pour obtenir l'ARN d'une couche, exécutez la commande describe-layers.

Pour ajouter des balises à l'aide du AWS CLI

• À l'invite de AWS CLI commande, tapez la commande suivante, en remplaçant Stack_or_Layer_ARN et en spécifiant vos balises de paire clé-valeur, puis appuyez sur Entrée. L'échappement des guillemets est effectué avec des barres obliques inverses.

  aws opsworks tag-resource --resource-arn stack_or_layer_ARN --tags "{\"key\":\"value\",\"key\":\"value\"}"

  Voici un exemple.

  aws opsworks tag-resource --resource-arn arn:aws:opsworks:us-east-2:800000000003:stack/500b99c0-ec00-4cgg-8a0d-1000000jjd1b --tags "{\"Stage\":\"Production\",\"Organization\":\"Mobile\"}"

Pour supprimer des balises à l'aide du AWS CLI

• À l'invite de AWS CLI commande, tapez ce qui suit, puis appuyez sur Entrée.

  aws opsworks untag-resource --resource-arn stack_or_layer_ARN --tag-keys "[\"key\",\"key\"]"

  Pour supprimer des balises, vous spécifiez uniquement la clé de la balise que vous voulez supprimer. Voici un exemple.

  aws opsworks untag-resource --resource-arn arn:aws:opsworks:us-east-2:800000000003:stack/500b99c0-ec00-4cgg-8a0d-1000000jjd1b --tag-keys "[\"Stage\",\"Organization\"]"

  Note

  Vous ne pouvez pas supprimer des balises héritées (des balises qui ont été ajoutées au niveau de la pile parent) d'une couche. Vous devez supprimer les balises héritées à partir de la pile.

Limitations des balises

Gardez les limitations suivantes à l'esprit lorsque vous créez des balises.

• AWS OpsWorks Stacks limite le nombre de balises définies par l'utilisateur au niveau de la pile et de la couche à 40, y compris les balises définies par l'utilisateur héritées d'un niveau parent. Cela laisse 10 emplacements disponibles pour les balises par défaut qui sont précédées et opsworks: les balises définies par d'autres AWS processus. Un maximum de 50 balises est autorisé sur une ressource, y compris les balises définies par l'utilisateur et les balises par défaut créées par AWS.

• Les clés de balise ne peuvent pas commencer par aws:, opsworks: ou rds:. Ne pas utiliser name ou Name comme clé de tag, car elle Name est réservée par AWS OpsWorks Stacks.

• Une clé peut comporter 127 caractères au maximum et ne peut contenir que des lettres, des chiffres ou séparateurs Unicode, ou les caractères spéciaux suivants : + - = . _ : / .

• Une valeur peut comporter 255 caractères au maximum et ne peut contenir que des lettres, des chiffres ou séparateurs Unicode, ou les caractères spéciaux suivants : + - = . _ : / .