# Versión 3 del punto de conexión de los metadatos de tareas de Amazon ECS
<a name="task-metadata-endpoint-v3"></a>

**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](task-metadata-endpoint-v4.md).  
Si utiliza tareas de Amazon ECS alojadas en AWS Fargate, consulte [Punto de conexión de metadatos de tareas de Amazon ECS versión 3 para tareas en Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v3-fargate.html).

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](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) 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 conexión de metadatos de tareas está habilitada de manera predeterminada para las tareas que utilizan Fargate en la versión 1.3.0 de la plataforma o una posterior, y en las tareas que utilizan EC2 y se lanzan en una infraestructura de Linux de Amazon EC2 que usa la versión 1.21.0 del agente de contenedor de Amazon ECS como mínimo una infraestructura de Windows de Amazon EC2 que use 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](manage-linux.md).

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](ecs-agent-update.md).

**importante**  
Para las tareas que utilizan Fargate y las versiones de la plataforma anteriores a la versión 1.3.0, se admite la versión 2 del punto de conexión 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](task-metadata-endpoint-v2.md).

## Rutas de la versión 3 del punto de conexión de los metadatos de tareas
<a name="task-metadata-endpoint-v3-paths"></a>

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

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