# Versión 4 del punto de conexión de los metadatos de tareas de Amazon ECS para tareas en Fargate
<a name="task-metadata-endpoint-v4-fargate"></a>

**importante**  
Si utiliza tareas de Amazon ECS alojadas en instancias de Amazon EC2, consulte [Amazon ECS task metadata endpoint](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint.html).

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](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats) 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
<a name="task-metadata-endpoint-v4-fargate-paths"></a>

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](task-metadata-endpoint-v4-fargate-response.md).

`${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](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats) en la documentación del API de Docker.  
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](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats) en la documentación del API de Docker.  
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.