Versión 3 del punto de conexión de los metadatos de tareas de Amazon ECS

importante

El punto de conexión de la versión 3 de los metadatos de la tarea ya no se mantiene activamente. Le recomendamos que actualice el punto de conexión de metadatos de la tarea versión 4 para obtener la información más reciente del punto de conexión de metadatos. Para obtener más información, consulte Versión 4 del punto de conexión de metadatos de tareas de Amazon ECS.

Si utiliza tareas de Amazon ECS alojadas en AWS Fargate, consulte Versión 3 del punto de enlace de metadatos de tareas en la Guía del usuario de Amazon Elastic Container Service para AWS Fargate.

A partir de la versión 1.21.0 del agente de contenedor de Amazon ECS, el agente introduce una variable de entorno con el nombre ECS_CONTAINER_METADATA_URI en cada contenedor de las tareas. Cuando consulta la versión 3 del punto de enlace de metadatos de tarea, están disponibles diversos metadatos de tarea y estadísticas de Docker para las tareas. En el caso de las tareas que utilizan el modo de red bridge, hay métricas de red disponibles que pueden utilizarse al consultar los puntos de enlace /stats.

La característica de la versión 3 del punto de enlace de metadatos de tareas está habilitada de forma predeterminada para las tareas que utilizan el tipo de lanzamiento de Fargate en la versión 1.3.0 de la plataforma o una posterior, y en las tareas que utilizan el tipo de lanzamiento de EC2 y se lanzan en una infraestructura de Linux de Amazon ECS que ejecuta la versión 1.21.0 del agente de contenedor de Amazon ECS como mínimo una infraestructura de Windows de Amazon EC2 que ejecute la versión 1.54.0 del agente de contenedor de Amazon ECS y utilice el modo de red awsvpc. Para obtener más información, consulte Administración de instancias de contenedor de Linux de Amazon ECS.

Puede añadir soporte para esta característica en instancias de contenedor anteriores actualizando el agente a la versión más reciente. Para obtener más información, consulte Actualización del agente de contenedor de Amazon ECS.

importante

Para las tareas que utilizan el tipo de lanzamiento de Fargate y las versiones de la plataforma anteriores a la versión 1.3.0, se admite la versión 2 del punto de enlace de metadatos de tareas. Para obtener más información, consulte Versión 2 del punto de conexión de los metadatos de tareas de Amazon ECS.

Rutas de la versión 3 del punto de conexión de los metadatos de tareas

Los siguientes puntos de enlace de metadatos de tarea están disponibles para los contenedores:

${ECS_CONTAINER_METADATA_URI}

Esta ruta devuelve JSON de metadatos para el contenedor.

${ECS_CONTAINER_METADATA_URI}/task

Esta ruta devuelve JSON de metadatos para la tarea, incluida una lista de los nombres e ID del contenedor de todos los contenedores asociados con la tarea. Para obtener más información sobre la respuesta de este punto de enlace, consulte Respuesta JSON para la versión 3 de los metadatos de tareas de Amazon ECS.

${ECS_CONTAINER_METADATA_URI}/taskWithTags

Esta ruta muestra los metadatos de la tarea incluidos en el punto de enlace /task, además de en las etiquetas de las instancias de contenedor y las tareas que se pueden recuperar mediante la API ListTagsForResource.

${ECS_CONTAINER_METADATA_URI}/stats

Esta ruta devuelve JSON de estadísticas de Docker para el ID de contenedor de Docker específico. Para obtener más información acerca de cada una de las estadísticas devueltas, consulte ContainerStats en la documentación del API de Docker.

${ECS_CONTAINER_METADATA_URI}/task/stats

Esta ruta devuelve JSON de estadísticas de Docker de todos los contenedores asociados con la tarea. Para obtener más información acerca de cada una de las estadísticas devueltas, consulte ContainerStats en la documentación del API de Docker.