# Versión 4 del punto de conexión de metadatos de tareas de Amazon ECS El agente de contenedor de Amazon ECS introduce una variable de entorno en cada contenedor, denominada *punto de enlace de metadatos de tareas*, que proporciona varios metadatos y [estadísticas de Docker](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats) de tareas al contenedor. Los metadatos y las estadísticas de velocidad de red de las tareas se envían a CloudWatch Container Insights y se pueden consultar desde la Consola de administración de AWS. Para obtener más información, consulte [Supervisión de contenedores de Amazon ECS mediante Información de contenedores con capacidad de observabilidad mejorada](cloudwatch-container-insights.md). **nota** Amazon ECS ofrece versiones anteriores del punto de enlace de metadatos de tareas. 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. La variable de entorno se introduce de forma predeterminada en los contenedores de las tareas de Amazon ECS lanzadas en instancias de Linux de Amazon EC2 que ejecutan la versión `1.39.0` del agente de contenedor de Amazon ECS como mínimo. Para instancias de Windows de Amazon EC2 que utilizan el modo de red `awsvpc`, el agente de contenedor de Amazon ECS debe ser versión `1.54.0` como mínimo. Para obtener más información, consulte [Administración de instancias de contenedor de Linux de Amazon ECS](manage-linux.md). **nota** Puede agregar compatibilidad con esta característica en instancias de Amazon EC2 que utilizan versiones anteriores del agente de contenedor de Amazon ECS si actualiza 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). Para ver una salida de ejemplo de metadatos de tareas, consulte [Ejemplos de la versión 4 de los metadatos de tareas de Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v4-examples.html). ## Rutas de la versión 4 del punto de enlace de metadatos de tareas Están disponibles los siguientes puntos de enlace de metadatos de tareas 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](task-metadata-endpoint-v4-response.md). `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags` Esta ruta muestra los metadatos de la tarea incluidos en el punto de enlace `/task` además de en las etiquetas de instancia de contenedor y tarea que se pueden recuperar mediante la API `ListTagsForResource`. Todos los errores recibidos al recuperar los metadatos de la etiqueta se incluirán en la respuesta, en el campo `Errors`. El campo `Errors` solo aparece en la respuesta para tareas alojadas en instancias de Linux de Amazon EC2 que ejecutan la versión `1.50.0` del agente de contenedor como mínimo. Para instancias de Windows de Amazon EC2 que utilizan el modo de red `awsvpc`, el agente contenedor de Amazon ECS debe ser versión `1.54.0` como mínimo Este punto de conexión requiere el permiso `ecs.ListTagsForResource`. Cuando utilice el punto de conexión `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags`, tenga en cuenta que cada llamada hace hasta dos solicitudes de API a `ecs:ListTagsForResource` (una para las etiquetas de las instancias de contenedor y otra para las etiquetas de tareas) y que los contenedores asociados de la tarea pueden hacer estas llamadas en su nombre. Las llamadas frecuentes a los puntos de conexión pueden provocar una limitación de las API. Considere la posibilidad de implementar las estrategias de almacenamiento en caché o procesamiento por lotes para reducir la frecuencia de las llamadas, especialmente en aplicaciones de alto tráfico y depurar los problemas de limitación de las API mediante AWS CloudTrail. Para obtener información sobre la limitación de las API `ListTagsForResource`, consulte [Request throttling for the Amazon ECS API](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/request-throttling.html) en la *Referencia de la API de Amazon Elastic Container Service*. Para más información sobre la depuración de las llamadas a la API de Amazon ECS mediante AWS CloudTrail, consulte [Registro de llamadas a la API de Amazon ECS mediante AWS CloudTrail](logging-using-cloudtrail.md). `${ECS_CONTAINER_METADATA_URI_V4}/stats` Esta ruta muestra estadísticas de Docker para el contenedor específico. 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. Para las tareas de Amazon ECS que utilizan los modos de red `awsvpc`o `bridge` alojados en instancias de Linux de Amazon EC2 que ejecutan la versión `1.43.0` del agente de contenedor como mínimo, habrá estadísticas de velocidad de red adicionales incluidas en la respuesta. Para todas las demás tareas, la respuesta solo incluirá las estadísticas de red acumuladas. `${ECS_CONTAINER_METADATA_URI_V4}/task/stats` Esta ruta devuelve estadísticas de Docker de todos los contenedores asociados a la tarea. Se puede utilizar en contenedores asociados para extraer métricas de red. 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. Para las tareas de Amazon ECS que utilizan los modos de red `awsvpc`o `bridge` alojados en instancias de Linux de Amazon EC2 que ejecutan la versión `1.43.0` del agente de contenedor como mínimo, habrá estadísticas de velocidad de red adicionales incluidas en la respuesta. Para todas las demás tareas, la respuesta solo incluirá las estadísticas de red acumuladas.