Marquer les ressources Amazon ECS - Amazon Elastic Container Service
Comment les ressources sont étiquetéesBalisage des ressources à la créationRestrictionsTags ECS gérés par AmazonUtiliser des tags pour la facturation

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.

Marquer les ressources Amazon ECS

Pour vous aider à gérer vos ECS ressources Amazon, vous pouvez éventuellement attribuer 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 balises pour classer vos ECS ressources Amazon de différentes manières, par exemple par objectif, propriétaire ou 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 un ensemble de balises pour les instances de ECS conteneur Amazon de votre compte. 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 l'utilisation de vos ECS ressources Amazon. Pour de plus amples informations, veuillez consulter Rapports ECS d'utilisation d'Amazon.

Avertissement

Il y en a beaucoup APIs qui renvoient les clés des balises et leurs valeurs. Le fait de refuser l'accès à DescribeTags ne refuse pas automatiquement l'accès aux balises renvoyées par d'autresAPIs. 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 tags n'ont aucune signification sémantique pour Amazon ECS et sont interprétés 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, ECS les définitions de tâches et les clusters Amazon sont balisés de différentes manières :

  • Un utilisateur balise manuellement une ressource en utilisant le AWS Management Console, Amazon ECSAPI, le AWS CLI, ou un AWS SDK.

  • Un utilisateur crée un service ou exécute une tâche autonome et sélectionne l'option Amazon ECS -managed tags.

    Amazon étiquette ECS automatiquement toutes les tâches nouvellement lancées. Pour de plus amples informations, veuillez consulter Tags ECS gérés par Amazon.

  • 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 AWS SDK réponses 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 Tags ajoutés automatiquement par la console dans le tableau des ECSressources Amazon relatives au balisage.

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 ECS ressources Amazon qui prennent en charge le balisage.

Support de 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

ECSTâches Amazon

Oui

Oui, à partir de la définition de tâche.

 Clé : aws:ecs:clusterName

Value (Valeur) : cluster-name

ECSServices Amazon

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 ECS de tâches Amazon

Oui

Non

 N/A

Définitions ECS de tâches Amazon

Oui

Non

 Clé : ecs:taskDefinition:createdFrom

Value (Valeur) : ecs-console-v2

ECSClusters Amazon

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 ECS conteneurs Amazon

Oui

Oui, depuis l'EC2instance Amazon. Pour de plus amples informations, veuillez consulter Ajouter des balises à une instance de ECS conteneur Amazon.

N/A

Instances ECS externes Amazon

Oui

Non

 N/A
Fournisseur ECS de capacité Amazon 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 d'Amazon ECS API AWS CLI, ou AWS SDK :

  • ECSTâches Amazon

  • ECSServices Amazon

  • Définition des ECS tâches Amazon

  • Ensembles ECS de tâches Amazon

  • ECSClusters Amazon

  • Instances de ECS conteneurs Amazon

  • Fournisseurs ECS de capacité Amazon

Amazon ECS a la possibilité d'utiliser l'autorisation de balisage pour créer des 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 de plus amples informations, veuillez consulter 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 touches peuvent comporter jusqu'à 128 caractères en UTF -8.

  • Les valeurs peuvent comporter 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.

Tags ECS gérés par Amazon

Lorsque vous utilisez des balises ECS gérées par Amazon, Amazon étiquette ECS automatiquement toutes les tâches récemment lancées et tous les EBS volumes Amazon 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 EBS volume Amazon associé à une tâche autonome recevra le tag avec une clé sous forme de clé aws:ecs:clusterName et une valeur définies sur le nom du cluster. Pour plus d'informations sur le balisage des EBS volumes Amazon, 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 EBS volume Amazon 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 EBS volumes Amazon, consultez la section Marquage des volumes Amazon EBS.

Les options suivantes sont requises pour cette fonctionnalité :

  • Vous devez accepter les nouveaux formats Amazon Resource Name (ARN) et Resource Identifier (ID). Pour de plus amples informations, veuillez consulter Amazon Resource Names (ARNs) et IDs.

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

  • Amazon ECS utilise des balises gérées pour déterminer à quel moment certaines fonctionnalités sont activées, par exemple le cluster Auto Scaling. 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 ECS ressources Amazon.

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 ECS gérées par Amazon ou des balises ajoutées par l'utilisateur pour votre rapport sur les coûts et l'utilisation. Pour de plus amples informations, veuillez consulter Rapports ECS d'utilisation d'Amazon.

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 pour obtenir des données sur le niveau des tâches CPU et l'utilisation de la mémoire dans vos rapports sur les coûts et l'utilisation de la mémoire. Pour de plus amples informations, veuillez consulter 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.