Versión 4 del punto de conexión de los metadatos de tareas de Amazon ECS para tareas en Fargate - Amazon Elastic Container Service

Versión 4 del punto de conexión de los metadatos de tareas de Amazon ECS para tareas en Fargate

importante

Si utiliza tareas de Amazon ECS alojadas en instancias de Amazon EC2, consulte Amazon ECS task metadata endpoint.

A partir de la versión 1.4.0 de la plataforma de Fargate, se ha incluido una variable de entorno con el nombre ECS_CONTAINER_METADATA_URI_V4 en cada contenedor de una tarea. Cuando consulta la versión 4 del punto de enlace de metadatos de tareas, hay diversos metadatos y estadísticas de Docker disponibles para las tareas.

La versión 4 del punto de enlace de metadatos de tareas funciona como la versión 3, pero proporciona metadatos de red adicionales para los contenedores y las tareas. También hay otras métricas de red que están disponibles al consultar los puntos de enlace /stats.

El punto de conexión de metadatos de tareas está habilitado de forma predeterminada para todas las tareas de Amazon ECS que se ejecutan en AWS Fargate y utilizan la versión de la plataforma 1.4.0 o una posterior.

nota

Para no tener que crear nuevas versiones de los puntos de enlace de metadatos de tareas en el futuro, se pueden agregar otros metadatos a la salida de la versión 4. No vamos a eliminar ningún metadato existente ni a modificar los nombres de los campos de metadatos.

Rutas de la versión 4 del punto de conexión de metadatos de tareas de Fargate

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

${ECS_CONTAINER_METADATA_URI_V4}

Esta ruta devuelve metadatos del contenedor.

${ECS_CONTAINER_METADATA_URI_V4}/task

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

${ECS_CONTAINER_METADATA_URI_V4}/stats

Esta ruta devuelve estadísticas de Docker del contenedor de Docker. 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.

nota

Las tareas de Amazon ECS alojadas en AWS Fargate requieren que el contenedor se ejecute durante ~1 segundo antes de devolver las estadísticas del contenedor.

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

Esta ruta devuelve estadísticas de Docker de todos los contenedores asociados a 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.

nota

Las tareas de Amazon ECS alojadas en AWS Fargate requieren que el contenedor se ejecute durante ~1 segundo antes de devolver las estadísticas del contenedor.