Point de terminaison des métadonnées des tâches Amazon ECS, version 4 - Amazon Elastic Container Service
Chemins des points de terminaison des métadonnées de tâches version 4

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.

Point de terminaison des métadonnées des tâches Amazon ECS, version 4

L'agent de conteneur Amazon ECS injecte une variable d'environnement dans chaque conteneur, appelée point de terminaison des métadonnées de tâches, qui fournit diverses métadonnées de tâches et statistiques Docker au conteneur.

Les métadonnées des tâches et les statistiques du débit du réseau sont envoyées à CloudWatch Container Insights et peuvent être consultées dans le AWS Management Console. Pour de plus amples informations, veuillez consulter Surveillez les conteneurs Amazon ECS à l'aide de Container Insights avec une observabilité améliorée.

Note

Amazon ECS fournit des versions antérieures du point de terminaison des métadonnées de tâches. Pour éviter de créer d'autres versions de point de terminaison de métadonnées de tâche à l'avenir, des métadonnées supplémentaires peuvent être ajoutées à la sortie de la version 4. Nous ne supprimons pas les métadonnées existantes et ne modifions pas les noms des champs de métadonnées.

La variable d'environnement est injectée par défaut dans les conteneurs des tâches Amazon ECS lancées sur des instances Amazon EC2 Linux qui exécutent au moins une version 1.39.0 de l'agent de conteneur Amazon ECS. Pour les instances Amazon EC2 Windows qui utilisent le mode awsvpc réseau, l'agent de conteneur Amazon ECS doit être au moins une version1.54.0. Pour de plus amples informations, veuillez consulter Gestion des instances de conteneurs Linux Amazon ECS.

Note

Vous pouvez ajouter la prise en charge de cette fonctionnalité sur les EC2 instances Amazon utilisant d'anciennes versions de l'agent de conteneur Amazon ECS en mettant à jour l'agent vers la dernière version. Pour de plus amples informations, veuillez consulter Mise à jour de l'agent de conteneur Amazon ECS.

Chemins des points de terminaison des métadonnées de tâches version 4

Les chemins des points de terminaison des métadonnées de tâches suivants sont disponibles pour les conteneurs :

${ECS_CONTAINER_METADATA_URI_V4}

Ce chemin renvoie des métadonnées pour le conteneur.

${ECS_CONTAINER_METADATA_URI_V4}/task

Ce chemin renvoie les métadonnées de la tâche, y compris une liste des conteneurs IDs et les noms de tous les conteneurs associés à la tâche. Pour plus d'informations sur la réponse pour ce point de terminaison, consultez Réponse JSON V4 aux métadonnées des tâches Amazon ECS.

${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags

Ce chemin renvoie les métadonnées de la tâche incluse dans le point de terminaison /task en plus des balises de tâche et d'instance de conteneur qui peuvent être récupérées à l'aide de l'API ListTagsForResource. Toutes les erreurs reçues lors de la récupération des métadonnées de balise seront incluses dans le champ Errors de la réponse.

Note

Le Errors champ figure uniquement dans la réponse pour les tâches hébergées sur des instances Amazon EC2 Linux exécutant au moins une version 1.50.0 de l'agent de conteneur. Pour les instances Amazon EC2 Windows qui utilisent le mode awsvpc réseau, l'agent de conteneur Amazon ECS doit être au moins la version 1.54.0

Ce point de terminaison nécessite l'autorisation ecs.ListTagsForResource.

${ECS_CONTAINER_METADATA_URI_V4}/stats

Ce chemin renvoie les statistiques Docker pour ce conteneur spécifique. Pour plus d'informations sur chacune des statistiques renvoyées, consultez la documentation ContainerStatsde l'API Docker.

Pour les tâches Amazon ECS qui utilisent le mode bridge réseau awsvpc ou le mode réseau hébergés sur des instances Amazon EC2 Linux exécutant au moins une version 1.43.0 de l'agent de conteneur, des statistiques supplémentaires sur le débit du réseau seront incluses dans la réponse. Pour toutes les autres tâches, la réponse inclura uniquement les statistiques cumulatives du réseau.

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

Ce chemin renvoie les statistiques Docker pour tous les conteneurs associés à la tâche. Il peut être utilisé par les conteneurs sidecar pour extraire les métriques réseau. Pour plus d'informations sur chacune des statistiques renvoyées, consultez la documentation ContainerStatsde l'API Docker.

Pour les tâches Amazon ECS qui utilisent le mode bridge réseau awsvpc ou le mode réseau hébergés sur des instances Amazon EC2 Linux exécutant au moins une version 1.43.0 de l'agent de conteneur, des statistiques supplémentaires sur le débit du réseau seront incluses dans la réponse. Pour toutes les autres tâches, la réponse inclura uniquement les statistiques cumulatives du réseau.