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

Important

Le point de terminaison des métadonnées de tâches version 3 n'est plus activement maintenu. Nous vous recommandons de mettre à jour le point de terminaison des métadonnées de tâches version 4 afin d'obtenir les dernières informations relatives au point de terminaison des métadonnées. Pour de plus amples informations, veuillez consulter Point de terminaison des métadonnées des ECS tâches Amazon, version 4.

Si vous utilisez des ECS tâches Amazon hébergées sur AWS Fargate, consultez la version 3 du point de terminaison des métadonnées des tâches dans le guide de l'utilisateur d'Amazon Elastic Container Service pour AWS Fargate.

À partir de la version 1.21.0 de l'agent de ECS conteneur Amazon, l'agent injecte une variable d'environnement appelée ECS_CONTAINER_METADATA_URI dans chaque conteneur d'une tâche. Lorsque vous interrogez le point de terminaison des métadonnées de tâches version 3, diverses métadonnées de tâches et statistiques Docker sont disponibles pour les tâches. Pour les tâches qui utilisent le mode réseau bridge, les métriques réseau sont disponibles sont disponibles lors de l'interrogation des points de terminaison /stats.

La fonctionnalité de point de terminaison des métadonnées des tâches version 3 est activée par défaut pour les tâches qui utilisent le type de lancement Fargate sur la version v1.3.0 ou ultérieure de la plateforme et les tâches qui utilisent EC2 le type de lancement et sont lancées sur l'infrastructure EC2 Amazon Linux exécutant au moins la version 1.21.0 de l'agent de ECS conteneur Amazon ou sur l'infrastructure EC2 Amazon Windows exécutant au moins une version 1.54.0 de l'agent de conteneur ECS Amazon et utilisant le mode réseau. awsvpc Pour de plus amples informations, veuillez consulter Gestion des instances de conteneurs Amazon ECS Linux.

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

Important

Pour les tâches qui utilisent le type de lancement Fargate et les versions de plateforme antérieures à v1.3.0, le point de terminaison des métadonnées de tâches version 2 est pris en charge. Pour de plus amples informations, veuillez consulter Point de terminaison des métadonnées des ECS tâches Amazon, version 2.

Chemins du point de terminaison des métadonnées des tâches version 3

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

${ECS_CONTAINER_METADATA_URI}

Ce chemin renvoie JSON les métadonnées du conteneur.

${ECS_CONTAINER_METADATA_URI}/task

Ce chemin renvoie JSON 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 aux métadonnées des ECS tâches Amazon v3 JSON.

${ECS_CONTAINER_METADATA_URI}/taskWithTags

Ce chemin renvoie les métadonnées de la tâche incluse dans le /task point de terminaison, en plus des balises d'instance de tâche et de conteneur qui peuvent être récupérées à l'aide du ListTagsForResourceAPI.

${ECS_CONTAINER_METADATA_URI}/stats

Ce chemin renvoie les statistiques Docker JSON pour le conteneur Docker spécifique. Pour plus d'informations sur chacune des statistiques renvoyées, consultez ContainerStatsla API documentation Docker.

${ECS_CONTAINER_METADATA_URI}/task/stats

Ce chemin renvoie les statistiques Docker JSON pour tous les conteneurs associés à la tâche. Pour plus d'informations sur chacune des statistiques renvoyées, consultez ContainerStatsla API documentation Docker.