Point de terminaison des métadonnées de tâches Amazon ECS version 4 pour les tâches sur Fargate
Important
Si vous utilisez des tâches Amazon ECS hébergées sur des instances Amazon EC2, consultez la section Point de terminaison des métadonnées de tâche Amazon ECS.
À partir de la version 1.4.0 de la plateforme Fargate, une variable d'environnement nommée ECS_CONTAINER_METADATA_URI_V4 est injectée dans chaque conteneur d'une tâche. Lorsque vous interrogez le point de terminaison des métadonnées de tâches version 4, diverses métadonnées de tâches et statistiques Docker
Le point de terminaison des métadonnées de tâche version 4 fonctionne comme dans la version 3, mais fournit des métadonnées réseau supplémentaires pour vos conteneurs et tâches. Des métriques réseau supplémentaires sont disponibles lors de l'interrogation des points de terminaison /stats.
Le point de terminaison des métadonnées de tâches est activé par défaut pour toutes les tâches Amazon ECS exécutées sur AWS Fargate qui utilisent la version de plateforme 1.4.0 ou ultérieure.
Note
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.
Chemins des points de terminaison des métadonnées de tâches Fargate version 4
Les 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 pour la tâche, y compris une liste des ID et noms de conteneur pour 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 des métadonnées de tâches Amazon ECS v4 pour les tâches sur Fargate.
${ECS_CONTAINER_METADATA_URI_V4}/stats-
Ce chemin renvoie les statistiques Docker pour le conteneur Docker. Pour plus d'informations sur toutes les statistiques renvoyées, consultez ContainerStats
dans la documentation de l'API Docker. Note
Les tâches Amazon ECS sur AWS Fargate exigent que le conteneur s'exécute pendant une seconde environ avant de renvoyer les statistiques du conteneur.
${ECS_CONTAINER_METADATA_URI_V4}/task/stats-
Ce chemin renvoie les statistiques Docker pour tous les conteneurs associés à la tâche. Pour plus d'informations sur toutes les statistiques renvoyées, consultez ContainerStats
dans la documentation de l'API Docker. Note
Les tâches Amazon ECS sur AWS Fargate exigent que le conteneur s'exécute pendant une seconde environ avant de renvoyer les statistiques du conteneur.