Point de terminaison des métadonnées de tâche Amazon ECS version 4 pour les tâches sur instances gérées Amazon ECS - Amazon Elastic Container Service

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 de tâche Amazon ECS version 4 pour les tâches sur instances gérées Amazon ECS

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 des instances gérées Amazon ECS, 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 sont disponibles pour les tâches.

Le point de terminaison des métadonnées de tâche est activé par défaut pour toutes les tâches Amazon ECS exécutées sur des instances gérées Amazon ECS.

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 d’accès au point de terminaison des métadonnées de tâche des instances gérées Amazon ECS 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 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 des métadonnées de tâche Amazon ECS v4 pour les tâches sur les instances gérées Amazon ECS.

${ECS_CONTAINER_METADATA_URI_V4}/stats

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

Note

Les tâches Amazon ECS sur instances gérées Amazon ECS exigent que le conteneur s’exécute pendant environ 1 seconde 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 chacune des statistiques renvoyées, consultez la documentation ContainerStatsde l'API Docker.

Note

Les tâches Amazon ECS sur instances gérées Amazon ECS exigent que le conteneur s’exécute pendant environ 1 seconde avant de renvoyer les statistiques du conteneur.