Balisage des ressources Amazon ECS

Pour vous aider à gérer vos ressources Amazon ECS, vous pouvez éventuellement affecter vos propres métadonnées à chaque ressource à l'aide de balises. Chaque balise est constituée d'une clé et d'une valeur facultative.

Vous pouvez utiliser des étiquettes pour classer vos ressources Amazon ECS de différentes manières, par exemple, par objectif, par propriétaire ou par environnement. Cela est utile lorsque vous avez de nombreuses ressources du même type. Vous pouvez identifier rapidement une ressource spécifique en fonction des étiquettes que vous lui avez attribuées. Par exemple, vous pouvez définir pour les instances de votre compte Amazon ECS un ensemble d'étiquettes. Cela vous aide à suivre le propriétaire et le niveau de la pile de chaque instance.

Vous pouvez utiliser des balises pour vos Rapports d'utilisation et de coût. Vous pouvez utiliser ces rapports pour analyser le coût et de l'utilisation de vos ressources Amazon ECS. Pour plus d’informations, consultez Rapports d'utilisation d'Amazon ECS.

Avertissement

De nombreuses API renvoient les clés de balise et leurs valeurs. Le fait de refuser l’accès à DescribeTags ne refuse pas automatiquement l’accès aux balises renvoyées par d’autres API. Nous vous recommandons de ne pas inclure de données sensibles dans vos balises.

Nous vous recommandons de concevoir un ensemble de clés d’étiquette répondant à vos besoins pour chaque type de ressource. Vous pouvez utiliser un ensemble de clés de balise cohérent facilite la gestion de vos ressources. Vous pouvez rechercher et filtrer les ressources en fonction des étiquettes que vous ajoutez.

Les balises n'ont pas de signification sémantique pour Amazon ECS et sont interprétées strictement comme des chaînes de caractères. Vous pouvez modifier les clés et valeurs de balise, et vous pouvez retirer des balises d’une ressource à tout moment. Vous pouvez définir la valeur d'une étiquette sur une chaîne vide, mais vous ne pouvez pas définir la valeur d'une étiquette 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. Lorsque vous supprimez une ressource, toutes les balises associées à cette ressource sont également supprimées.

Si vous utilisez AWS Identity and Access Management (IAM), vous pouvez contrôler quels utilisateurs de votre AWS compte sont autorisés à gérer les tags.

Comment les ressources sont étiquetées

Les tâches, les services, les définitions de tâches Amazon ECS sont balisés de différentes manières :

• Un utilisateur balise manuellement une ressource à l' AWS Management Console aide de l'API Amazon ECS AWS CLI, du ou d'un AWS SDK.

• Un utilisateur crée un service ou exécute une tâche autonome et sélectionne l'option de balises gérées par Amazon ECS.

  Amazon ECS étiquette automatiquement toutes les tâches récemment lancées. Pour plus d’informations, consultez Balises gérées par Amazon ECS.

• Un utilisateur crée une ressource à l'aide de la console. La console étiquette automatiquement les ressources.

  Ces balises sont renvoyées dans AWS CLI les réponses du AWS SDK et sont affichées dans la console. Vous ne pouvez pas modifier ni supprimer ces balises.

  Pour plus d'informations sur les balises ajoutées, consultez la colonne Balises ajoutées automatiquement par la console dans le tableau des ressources relatives à la prise en charge du balisage pour Amazon ECS.

Si vous spécifiez des balises lorsque vous créez une ressource et que les balises ne peuvent pas être appliquées, Amazon ECS annule le processus de création. Cela permet de s'assurer que les ressources sont créées avec des étiquettes ou qu'elles ne sont pas créées du tout, et qu'aucune ressource ne demeurent sans étiquette à tout moment. En attribuant des étiquettes aux ressources au moment de la création, vous pouvez supprimer la nécessité d'exécuter des scripts d'identification personnalisés après la création de ressources.

Le tableau suivant décrit les ressources Amazon ECS qui prennent en charge les balises.

Prise en charge du balisage pour les ressources Amazon ECS
Ressource	Prend en charge les étiquettes	Prend en charge la propagation des étiquettes	Balises ajoutées automatiquement par la console
Tâches Amazon ECS	Oui	Oui, à partir de la définition de tâche.	Clé : aws:ecs:clusterName Value (Valeur) : cluster-name
Services Amazon ECS	Oui	Oui, à partir soit de la définition de tâche ou de service pour les tâches dans le service.	Clé : ecs:service:stackId Value (Valeur) : arn:aws:cloudformation:arn
Ensembles de tâches Amazon ECS	Oui	Non	N/A
Définitions de tâche Amazon ECS	Oui	Non	Clé : ecs:taskDefinition:createdFrom Value (Valeur) : ecs-console-v2
Clusters Amazon ECS	Oui	Non	Clé : aws:cloudformation:logical-id Value (Valeur) : ECSCluster Clé : aws:cloudformation:stack-id Value (Valeur) : arn:aws:cloudformation:arn Clé : aws:cloudformation:stack-name Value (Valeur) : ECS-Console-V2-Cluster-EXAMPLE
Instances de conteneur Amazon ECS	Oui	Oui, à partir de l'instance Amazon EC2. Pour plus d’informations, consultez Ajouter des balises à une instance de conteneur Amazon ECS.	N/A
Instances Amazon ECS externes	Oui	Non	N/A
Fournisseur de capacité Amazon ECS	Oui. Vous ne pouvez pas étiqueter les fournisseurs prédéfinis de capacité FARGATE et FARGATE_SPOT.	Non	N/A

Balisage des ressources à la création

Les ressources suivantes prennent en charge le balisage lors de la création à l'aide de l'API ou du AWS SDK Amazon ECS : AWS CLI

• Tâches Amazon ECS

• Services Amazon ECS

• Définition de tâche Amazon ECS

• Ensembles de tâches Amazon ECS

• Clusters Amazon ECS

• Instances de conteneur Amazon ECS

• Fournisseurs de capacité Amazon ECS

Amazon ECS a la possibilité d'utiliser l'autorisation de balisage pour la création de ressources. Lorsque le Compte AWS est configuré pour l'autorisation de balisage, les utilisateurs doivent disposer d'autorisations pour les actions qui créent la ressource, telles queecsCreateCluster. Si vous spécifiez des balises dans l'action de création de ressources, AWS effectue une autorisation supplémentaire pour vérifier si les utilisateurs ou les rôles sont autorisés à créer des balises. Par conséquent, vous devez octroyer des autorisations explicites d'utiliser l'action ecs:TagResource. Pour plus d’informations, consultez Octroi de l'autorisation de baliser les ressources lors de la création. Pour plus d'informations sur la configuration de l'option, consultezAutorisation de balisage.

Restrictions

Les restrictions suivantes s’appliquent aux balises :

• Un maximum de 50 balises peut être associé à une ressource.

• Les clés de balises ne peuvent pas être répétées pour une même ressource. Chaque clé de balise doit être unique et ne peut avoir qu'une seule valeur.

• Les clés peuvent contenir jusqu'à 128 caractères en UTF-8.

• Les valeurs peuvent contenir jusqu'à 256 caractères en UTF-8.

• Si plusieurs Services AWS ressources utilisent votre schéma de balisage, limitez les types de caractères que vous utilisez. Certains services peuvent présenter des restrictions sur les caractères autorisés. Les caractères généralement autorisés sont les lettres, les chiffres, les espaces et les caractères suivants : + - = . _ : / @.

• Les clés et valeurs de balise sont sensibles à la casse.

• Vous ne pouvez pas utiliser aws:, AWS: ou n'importe quelle combinaison de majuscules ou minuscules de ce préfixe pour des clés ou des valeurs Ils sont réservés uniquement à AWS l'usage. 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.

Balises gérées par Amazon ECS

Lorsque vous utilisez des balises gérées par Amazon ECS, Amazon ECS étiquette automatiquement toutes les tâches récemment lancées et tous les volumes Amazon EBS attachés aux tâches avec les informations du cluster et soit les balises de définition de tâche ajoutées par l'utilisateur, soit les balises de service. Les balises ajoutées sont décrites ci-dessous :

• Tâches autonomes : une balise avec une clé en tant que aws:ecs:clusterName et une valeur définies en fonction du nom du cluster. Toutes les balises de définition de tâches qui ont été ajoutées par les utilisateurs. Un volume Amazon EBS associé à une tâche autonome recevra le tag avec une clé aws:ecs:clusterName et une valeur définies sur le nom du cluster. Pour plus d'informations sur le balisage des volumes Amazon EBS, consultez la section Marquage des volumes Amazon EBS.

• Tâches faisant partie d’un service : une balise avec une clé en tant que aws:ecs:clusterName et une valeur définies en fonction du nom du cluster. Balise avec une clé en tant que aws:ecs:serviceName et une valeur définies en fonction du nom du service. Balises de l’une des ressources suivantes.

  • Définitions de tâches : toutes les balises de définition de tâches qui ont été ajoutées par les utilisateurs.

  • Services : toutes les balises de service qui ont été ajoutées par les utilisateurs.

    Un volume Amazon EBS associé à une tâche faisant partie d'un service recevra une balise avec une clé sous forme aws:ecs:clusterName et une valeur définies sur le nom du cluster, et une balise avec une clé en tant que aws:ecs:serviceName et une valeur définies sur le nom du service. Pour plus d'informations sur le balisage des volumes Amazon EBS, consultez la section Marquage des volumes Amazon EBS.

Les options suivantes sont requises pour cette fonctionnalité :

• Vous devez vous inscrire au nouveaux formats Amazon Resource Name (ARN) et identifiants de ressource (ID). Pour plus d’informations, consultez Amazon Resource Names (ARN) et ID.

• Lorsque vous utilisez les API pour créer un service ou exécuter une tâche, vous devez définir enableECSManagedTags sur true pour run-task et create-service. Pour plus d'informations, consultez create-service et run-task dans la Référence API d'AWS Command Line Interface .

• Amazon ECS utilise des balises gérées pour déterminer à quel moment certaines fonctionnalités sont activées, par exemple l'autoscaling de cluster. Nous vous recommandons de ne pas modifier manuellement les balises afin qu'Amazon ECS puisse gérer efficacement les fonctionnalités.

Utiliser des tags pour la facturation

AWS fournit un outil de reporting appelé Cost Explorer que vous pouvez utiliser pour analyser le coût et l'utilisation de vos ressources Amazon ECS.

Vous pouvez utiliser Cost Explorer pour afficher les graphiques de votre utilisation et de vos coûts. Vous pouvez afficher les données des 13 derniers mois et prévoir vos dépenses pour les trois prochains mois. Vous pouvez utiliser Cost Explorer pour afficher des schémas de vos dépenses en ressources AWS au fil du temps. Par exemple, vous pouvez l'utiliser pour identifier les zones qui méritent d'être approfondies et connaître les tendances que vous pouvez utiliser pour comprendre vos coûts. Vous pouvez également spécifier des plages de temps pour les données et afficher des données temporelles par jour ou par mois.

Vous pouvez utiliser des balises gérées par Amazon ECS ou des balises ajoutées par l'utilisateur pour votre rapport sur les coûts et l'utilisation. Pour plus d’informations, consultez Rapports d'utilisation d'Amazon ECS.

Pour voir le coût de vos ressources combinées, vous pouvez organiser vos informations de facturation en fonction des ressources possédant les mêmes valeurs de clé d‘étiquette. Par exemple, vous pouvez étiqueter plusieurs ressources avec un nom d'application spécifique, puis organiser vos informations de facturation pour afficher le coût total de cette application dans plusieurs services. Pour en savoir plus sur la configuration d'un rapport de répartition des coûts avec des étiquettes, consultez Rapport d'allocation des coûts mensuel dans le guide de l'utilisateur AWS Billing .

En outre, vous pouvez activer les données de répartition des coûts fractionnés pour obtenir des données d'utilisation de la mémoire et du processeur au niveau des tâches dans vos rapports d'utilisation et de coût. Pour plus d’informations, consultez Rapports d'utilisation et de coût au niveau des tâches.

Note

Si vous avez activé la création de rapports, 24 heures peuvent être nécessaires avant que les données du mois en cours puissent être consultées.