# Metadatos de tareas disponibles para tareas de Amazon ECS en EC2 El agente de contenedor de Amazon ECS proporciona un método para recuperar varios metadatos y [estadísticas de Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) de tareas. Esto se conoce como el punto de enlace de metadatos de tarea. Están disponibles las siguientes versiones: + Versión 4 del punto de enlace de metadatos de tareas: proporciona diversos metadatos y estadísticas de Docker a los contenedores. También puede proporcionar datos de velocidad de red. Disponible para las tareas de Amazon ECS lanzadas en instancias 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 [Versión 4 del punto de conexión de metadatos de tareas de Amazon ECS](task-metadata-endpoint-v4.md). + Versión 3 del punto de enlace de metadatos de tareas: proporciona diversos metadatos y estadísticas de Docker a los contenedores. Disponible para las tareas de Amazon ECS lanzadas en instancias Linux de Amazon EC2 que ejecutan la versión `1.21.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 [Versión 3 del punto de conexión de los metadatos de tareas de Amazon ECS](task-metadata-endpoint-v3.md). + Versión 2 del punto de enlace de metadatos de tareas: disponible para tareas de Amazon ECS lanzadas en instancias de Linux de Amazon EC2 que ejecutan la versión `1.17.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 [Versión 2 del punto de conexión de los metadatos de tareas de Amazon ECS](task-metadata-endpoint-v2.md). Si la tarea de Amazon ECS está alojada en Amazon EC2 o si la tarea utiliza el modo de red `host` y está alojada en instancias administradas de Amazon ECS, también puede acceder a los metadatos del host de tareas mediante el [punto de conexión del servicio de metadatos de instancias (IMDS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html)). El siguiente comando, cuando se ejecuta desde la instancia que aloja la tarea, muestra el ID de la instancia del host. ``` curl http://169.254.169.254/latest/meta-data/instance-id ``` Si la tarea de Amazon ECS está alojada en Amazon EC2 y en una configuración de solo IPv6, puede acceder a los metadatos del host de tareas mediante el punto de conexión del IMDS de IPv6. El comando siguiente, cuando se pone en marcha desde la instancia que aloja la tarea, muestra el id. de la instancia del host a través de IPv6. ``` curl http://[fd00:ec2::254]/latest/meta-data/instance-id ``` Para acceder al punto de conexión del IMDS de IPv6, habilite el punto de conexión del IMDS de IPv6 en la instancia de contenedor y configure también el modo de punto de conexión del servicio de metadatos mediante el proveedor de credenciales del IMDS para el SDK que elija a `IPv6`. Para obtener más información sobre cómo habilitar el punto de conexión del IMDS de IPv6 para la instancia de contenedor, consulte [Configuración de las opciones del servicio de metadatos de instancias](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html) en la *Guía del usuario de Amazon EC2*. Para obtener más información sobre el proveedor de credenciales del IMDS para los SDK, consulte [IMDS credential provider](https://docs.aws.amazon.com/sdkref/latest/guide/feature-imds-credentials.html) en la *Guía de referencia de SDK y herramientas de AWS*. **nota** No se puede acceder al punto de conexión del IMDS de IPv6 cuando la configuración de la cuenta de `awsvpcTrunking` está habilitada. Para acceder a las credenciales del rol de IAM de la instancia de contenedor cuando la configuración `awsvpcTrunking` está habilitada, puede utilizar un rol de IAM de tarea en su lugar. Para obtener más información acerca de los roles de IAM de tarea, consulte [Rol de IAM de tarea de Amazon ECS](task-iam-roles.md). La información que puede obtener desde el punto de conexión se divide en categorías como `instance-id`. Para obtener más información acerca de las diferentes categorías de metadatos de instancias de host que puede obtener mediante el punto de conexión, consulte [Categorías de metadatos de instancias](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html#instancedata-data-categories). # 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. # Respuesta JSON para la versión 4 de los metadatos de tareas de Amazon ECS La siguiente información se devuelve desde la respuesta de JSON (`${ECS_CONTAINER_METADATA_URI_V4}/task`) de punto de enlace de metadatos de tarea. Esto incluye los metadatos asociados a la tarea, además de los metadatos de cada contenedor dentro de la tarea. `Cluster` El nombre de recurso de Amazon (ARN) o el nombre corto del clúster de Amazon ECS al que pertenece la tarea. `ServiceName` El nombre del servicio al que pertenece la tarea. ServiceName aparecerá para las instancias de contenedor de Amazon EC2 y Amazon ECS Anywhere si la tarea está asociada a un servicio. Los metadatos de `ServiceName` solo se incluyen cuando se utiliza la versión `1.63.1` o una posterior del agente de contenedores de Amazon ECS. `VPCID` El ID de VPC de la instancia de contenedor de Amazon EC2. Este campo solo aparece para las instancias de Amazon EC2. Los metadatos de `VPCID` solo se incluyen cuando se utiliza la versión `1.63.1` o una posterior del agente de contenedores de Amazon ECS. `TaskARN` Nombre de recurso de Amazon (ARN) de la tarea al que pertenece el contenedor. `Family` La familia de la definición de tareas de Amazon ECS para la tarea. `Revision` La revisión de la definición de tareas de Amazon ECS para la tarea. `DesiredStatus` El estado deseado para la tarea de Amazon ECS. `KnownStatus` El estado conocido para la tarea de Amazon ECS. `Limits` Los límites de recursos especificados en el nivel de tarea, por ejemplo, CPU (expresado en vCPU) y memoria. Este parámetro se omite si no se definen límites de recurso. `PullStartedAt` La marca temporal del momento en que comenzó la primera extracción de la imagen del contenedor. `PullStoppedAt` La marca temporal del momento en que finalizó la última extracción de la imagen del contenedor. `AvailabilityZone` La zona de disponibilidad donde está la tarea. Los metadatos de la zona de disponibilidad solo están disponibles para las tareas de Fargate que utilicen la versión 1.4 o posterior (Linux) o 1.0.0 (Windows) de la plataforma. `LaunchType` El tipo de lanzamiento que usa la tarea. Cuando se utilizan proveedores de capacidad de clúster, indica si la tarea está utilizando la infraestructura Fargate o EC2. Este metadato `LaunchType` solo se incluye cuando se utiliza la versión `1.45.0` o posterior (Linux) o 1.0.0 o posterior (Windows) del agente de contenedor de Amazon ECS o una posterior. `Containers` Una lista de metadatos de contenedor para cada contenedor asociado con la tarea. `DockerId` El ID de Docker para el contenedor. Cuando usa Fargate, el ID es un hexadecimal de 32 dígitos seguido de un número de 10 dígitos. `Name` El nombre del contenedor tal y como se especifica en la definición de tarea. `DockerName` El nombre del contenedor suministrado a Docker. El agente de contenedor de Amazon ECS genera un nombre único para el contenedor a fin de evitar conflictos de nombre cuando se ejecutan en una sola instancia varias copias de la misma definición de tareas. `Image` La imagen para el contenedor. `ImageID` El resumen SHA-256 del manifiesto de la imagen. Este es el resumen que se puede usar para extraer la imagen utilizando el formato `repository-url/image@sha256:digest`. `Ports` Los puertos expuestos para el contenedor. Este parámetro se omite si no hay puertos expuestos. `Labels` Cualquier etiqueta aplicada al contenedor. Este parámetro se omite si no hay etiquetas aplicadas. `DesiredStatus` El estado deseado para el contenedor procedente de Amazon ECS. `KnownStatus` El estado conocido para el contenedor procedente de Amazon ECS. `ExitCode` El código de salida para el contenedor. Este parámetro se omite si el contenedor no ha salido. `Limits` Los límites de recursos especificados en el nivel de contenedor, por ejemplo, CPU (expresado en unidades de CPU) y memoria. Este parámetro se omite si no se definen límites de recurso. `CreatedAt` La marca de hora para cuando el contenedor se creó. Este parámetro se omite si el contenedor no ha se ha creado aún. `StartedAt` La marca de hora para cuando el contenedor se inició. Este parámetro se omite si el contenedor no ha se ha iniciado aún. `FinishedAt` La marca de hora para cuando el contenedor se detuvo. Este parámetro se omite si el contenedor no ha se ha detenido aún. `Type` El tipo del contenedor. Los contenedores que se especifican en su definición de tarea son de tipo `NORMAL`. Puede hacer caso omiso de otros tipos de contenedores que utiliza el agente de contenedor de Amazon ECS para el aprovisionamiento de recursos para tareas internas. `LogDriver` El controlador de registros que utiliza el contenedor. Este metadato `LogDriver` solo se incluye cuando se utiliza la versión `1.45.0` del agente de contenedor de Linux de Amazon ECS o una posterior. `LogOptions` Opciones del controlador de registros definidas para el contenedor. Este metadato `LogOptions` solo se incluye cuando se utiliza la versión `1.45.0` del agente de contenedor de Linux de Amazon ECS o una posterior. `ContainerARN` El nombre de recurso de Amazon (ARN) del contenedor. Este metadato `ContainerARN` solo se incluye cuando se utiliza la versión `1.45.0` del agente de contenedor de Linux de Amazon ECS o una posterior. `Networks` La información de red del contenedor, como la dirección IP y el modo de red. Este parámetro se omite si no se define ninguna información de red. `RestartCount` La cantidad de veces que se reinició el contenedor. Los metadatos `RestartCount` se incluyen solo si hay una política de reinicio habilitada para el contenedor. Para obtener más información, consulte [Reinicio de contenedores individuales en tareas de Amazon ECS con políticas de reinicio de contenedores](container-restart-policy.md). `ExecutionStoppedAt` La marca temporal para cuando el `DesiredStatus` de la tarea pasó a `STOPPED`. Esto ocurre cuando un contenedor esencial pasa a `STOPPED`. # Ejemplos de la versión 4 de los metadatos de tareas de Amazon ECS En los siguientes ejemplos, se muestran resultados de ejemplo de cada uno de los puntos de enlace de metadatos de tareas. ## Ejemplo de respuesta de metadatos del contenedor Cuando se consulta el punto de enlace `${ECS_CONTAINER_METADATA_URI_V4}`, solo se devuelven los metadatos relacionados con el propio contenedor. A continuación se muestra un ejemplo del resultado de una tarea que se ejecuta como parte de un servicio (MyService). ``` { "DockerId": "ea32192c8553fbff06c9340478a2ff089b2bb5646fb718b4ee206641c9086d66", "Name": "curl", "DockerName": "ecs-curltest-24-curl-cca48e8dcadd97805600", "Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest", "ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/8f03e41243824aea923aca126495f665", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "24" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 10, "Memory": 128 }, "CreatedAt": "2020-10-02T00:15:07.620912337Z", "StartedAt": "2020-10-02T00:15:08.062559351Z", "Type": "NORMAL", "LogDriver": "awslogs", "LogOptions": { "awslogs-create-group": "true", "awslogs-group": "/ecs/metadata", "awslogs-region": "us-west-2", "awslogs-stream": "ecs/curl/8f03e41243824aea923aca126495f665" }, "ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/0206b271-b33f-47ab-86c6-a0ba208a70a9", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.100" ], "AttachmentIndex": 0, "MACAddress": "0e:9e:32:c7:48:85", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-100.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] } ``` ## Ejemplo de respuesta de metadatos de las tareas Al consultar el punto de enlace `${ECS_CONTAINER_METADATA_URI_V4}/task`, se muestran los metadatos relacionados con la tarea de la que forma parte el contenedor, además de los metadatos de cada contenedor de la tarea. El siguiente es un ejemplo de salida. ``` { "Cluster": "default", "TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "Family": "curltest", "ServiceName": "MyService", "Revision": "26", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "PullStartedAt": "2020-10-02T00:43:06.202617438Z", "PullStoppedAt": "2020-10-02T00:43:06.31288465Z", "AvailabilityZone": "us-west-2d", "VPCID": "vpc-1234567890abcdef0", "LaunchType": "EC2", "Containers": [ { "DockerId": "598cba581fe3f939459eaba1e071d5c93bb2c49b7d1ba7db6bb19deeb70d8e38", "Name": "~internal~ecs~pause", "DockerName": "ecs-curltest-26-internalecspause-e292d586b6f9dade4a00", "Image": "amazon/amazon-ecs-pause:0.1.0", "ImageID": "", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "~internal~ecs~pause", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RESOURCES_PROVISIONED", "KnownStatus": "RESOURCES_PROVISIONED", "Limits": { "CPU": 0, "Memory": 0 }, "CreatedAt": "2020-10-02T00:43:05.602352471Z", "StartedAt": "2020-10-02T00:43:06.076707576Z", "Type": "CNI_PAUSE", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] }, { "DockerId": "ee08638adaaf009d78c248913f629e38299471d45fe7dc944d1039077e3424ca", "Name": "curl", "DockerName": "ecs-curltest-26-curl-a0e7dba5aca6d8cb2e00", "Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest", "ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 10, "Memory": 128 }, "CreatedAt": "2020-10-02T00:43:06.326590752Z", "StartedAt": "2020-10-02T00:43:06.767535449Z", "Type": "NORMAL", "LogDriver": "awslogs", "LogOptions": { "awslogs-create-group": "true", "awslogs-group": "/ecs/metadata", "awslogs-region": "us-west-2", "awslogs-stream": "ecs/curl/158d1c8083dd49d6b527399fd6414f5c" }, "ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/abb51bdd-11b4-467f-8f6c-adcfe1fe059d", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] } ] } ``` ## Respuesta de ejemplo de metadatos de tareas con etiquetas Cuando se consulta el punto de enlace `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags`, se muestran los metadatos relacionados con la tarea, incluidas las etiquetas dela tarea y la instancia de contenedor. El siguiente es un ejemplo de salida. ``` { "Cluster": "default", "TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "Family": "curltest", "ServiceName": "MyService", "Revision": "26", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "PullStartedAt": "2020-10-02T00:43:06.202617438Z", "PullStoppedAt": "2020-10-02T00:43:06.31288465Z", "AvailabilityZone": "us-west-2d", "VPCID": "vpc-1234567890abcdef0", "TaskTags": { "tag-use": "task-metadata-endpoint-test" }, "ContainerInstanceTags":{ "tag_key":"tag_value" }, "LaunchType": "EC2", "Containers": [ { "DockerId": "598cba581fe3f939459eaba1e071d5c93bb2c49b7d1ba7db6bb19deeb70d8e38", "Name": "~internal~ecs~pause", "DockerName": "ecs-curltest-26-internalecspause-e292d586b6f9dade4a00", "Image": "amazon/amazon-ecs-pause:0.1.0", "ImageID": "", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "~internal~ecs~pause", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RESOURCES_PROVISIONED", "KnownStatus": "RESOURCES_PROVISIONED", "Limits": { "CPU": 0, "Memory": 0 }, "CreatedAt": "2020-10-02T00:43:05.602352471Z", "StartedAt": "2020-10-02T00:43:06.076707576Z", "Type": "CNI_PAUSE", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] }, { "DockerId": "ee08638adaaf009d78c248913f629e38299471d45fe7dc944d1039077e3424ca", "Name": "curl", "DockerName": "ecs-curltest-26-curl-a0e7dba5aca6d8cb2e00", "Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest", "ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 10, "Memory": 128 }, "CreatedAt": "2020-10-02T00:43:06.326590752Z", "StartedAt": "2020-10-02T00:43:06.767535449Z", "Type": "NORMAL", "LogDriver": "awslogs", "LogOptions": { "awslogs-create-group": "true", "awslogs-group": "/ecs/metadata", "awslogs-region": "us-west-2", "awslogs-stream": "ecs/curl/158d1c8083dd49d6b527399fd6414f5c" }, "ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/abb51bdd-11b4-467f-8f6c-adcfe1fe059d", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] } ] } ``` ## Tarea de ejemplo con etiquetas con una respuesta de metadatos de error Cuando se consulta el punto de enlace `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags`, se muestran los metadatos relacionados con la tarea, incluidas las etiquetas dela tarea y la instancia de contenedor. Si se produce un error al recuperar los datos de etiquetado, el error se muestra en la respuesta. Esta es una respuesta de ejemplo de cuando el rol de IAM asociado a la instancia de contenedor no dispone del permiso `ecs:ListTagsForResource`. ``` { "Cluster": "default", "TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "Family": "curltest", "ServiceName": "MyService", "Revision": "26", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "PullStartedAt": "2020-10-02T00:43:06.202617438Z", "PullStoppedAt": "2020-10-02T00:43:06.31288465Z", "AvailabilityZone": "us-west-2d", "VPCID": "vpc-1234567890abcdef0", "Errors": [ { "ErrorField": "ContainerInstanceTags", "ErrorCode": "AccessDeniedException", "ErrorMessage": "User: arn:aws:sts::111122223333:assumed-role/ecsInstanceRole/i-0744a608689EXAMPLE is not authorized to perform: ecs:ListTagsForResource on resource: arn:aws:ecs:us-west-2:111122223333:container-instance/default/2dd1b186f39845a584488d2ef155c131", "StatusCode": 400, "RequestId": "cd597ef0-272b-4643-9bd2-1de469870fa6", "ResourceARN": "arn:aws:ecs:us-west-2:111122223333:container-instance/default/2dd1b186f39845a584488d2ef155c131" }, { "ErrorField": "TaskTags", "ErrorCode": "AccessDeniedException", "ErrorMessage": "User: arn:aws:sts::111122223333:assumed-role/ecsInstanceRole/i-0744a608689EXAMPLE is not authorized to perform: ecs:ListTagsForResource on resource: arn:aws:ecs:us-west-2:111122223333:task/default/9ef30e4b7aa44d0db562749cff4983f3", "StatusCode": 400, "RequestId": "862c5986-6cd2-4aa6-87cc-70be395531e1", "ResourceARN": "arn:aws:ecs:us-west-2:111122223333:task/default/9ef30e4b7aa44d0db562749cff4983f3" } ], "LaunchType": "EC2", "Containers": [ { "DockerId": "598cba581fe3f939459eaba1e071d5c93bb2c49b7d1ba7db6bb19deeb70d8e38", "Name": "~internal~ecs~pause", "DockerName": "ecs-curltest-26-internalecspause-e292d586b6f9dade4a00", "Image": "amazon/amazon-ecs-pause:0.1.0", "ImageID": "", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "~internal~ecs~pause", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RESOURCES_PROVISIONED", "KnownStatus": "RESOURCES_PROVISIONED", "Limits": { "CPU": 0, "Memory": 0 }, "CreatedAt": "2020-10-02T00:43:05.602352471Z", "StartedAt": "2020-10-02T00:43:06.076707576Z", "Type": "CNI_PAUSE", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] }, { "DockerId": "ee08638adaaf009d78c248913f629e38299471d45fe7dc944d1039077e3424ca", "Name": "curl", "DockerName": "ecs-curltest-26-curl-a0e7dba5aca6d8cb2e00", "Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest", "ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 10, "Memory": 128 }, "CreatedAt": "2020-10-02T00:43:06.326590752Z", "StartedAt": "2020-10-02T00:43:06.767535449Z", "Type": "NORMAL", "LogDriver": "awslogs", "LogOptions": { "awslogs-create-group": "true", "awslogs-group": "/ecs/metadata", "awslogs-region": "us-west-2", "awslogs-stream": "ecs/curl/158d1c8083dd49d6b527399fd6414f5c" }, "ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/abb51bdd-11b4-467f-8f6c-adcfe1fe059d", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] } ] } ``` ## Respuesta de ejemplo de estadísticas del contenedor Cuando se consulta el punto de enlace `${ECS_CONTAINER_METADATA_URI_V4}/stats`, se muestran las métricas de red del contenedor. Para las tareas de Amazon ECS que utilizan los modos de red `awsvpc`o `bridge` alojados en instancias de Amazon EC2 que ejecutan la versión `1.43.0` del agente de contenedor como mínimo, la respuesta incluirá estadísticas de velocidad de red adicionales. Para todas las demás tareas, la respuesta solo incluirá las estadísticas de red acumuladas. A continuación, se muestra un ejemplo del resultado de una tarea de Amazon ECS en Amazon EC2 que utiliza el modo de red `bridge`. ``` { "read": "2020-10-02T00:51:13.410254284Z", "preread": "2020-10-02T00:51:12.406202398Z", "pids_stats": { "current": 3 }, "blkio_stats": { "io_service_bytes_recursive": [ ], "io_serviced_recursive": [ ], "io_queue_recursive": [ ], "io_service_time_recursive": [ ], "io_wait_time_recursive": [ ], "io_merged_recursive": [ ], "io_time_recursive": [ ], "sectors_recursive": [ ] }, "num_procs": 0, "storage_stats": { }, "cpu_stats": { "cpu_usage": { "total_usage": 360968065, "percpu_usage": [ 182359190, 178608875 ], "usage_in_kernelmode": 40000000, "usage_in_usermode": 290000000 }, "system_cpu_usage": 13939680000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "precpu_stats": { "cpu_usage": { "total_usage": 360968065, "percpu_usage": [ 182359190, 178608875 ], "usage_in_kernelmode": 40000000, "usage_in_usermode": 290000000 }, "system_cpu_usage": 13937670000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "memory_stats": { "usage": 1806336, "max_usage": 6299648, "stats": { "active_anon": 606208, "active_file": 0, "cache": 0, "dirty": 0, "hierarchical_memory_limit": 134217728, "hierarchical_memsw_limit": 268435456, "inactive_anon": 0, "inactive_file": 0, "mapped_file": 0, "pgfault": 4185, "pgmajfault": 0, "pgpgin": 2926, "pgpgout": 2778, "rss": 606208, "rss_huge": 0, "total_active_anon": 606208, "total_active_file": 0, "total_cache": 0, "total_dirty": 0, "total_inactive_anon": 0, "total_inactive_file": 0, "total_mapped_file": 0, "total_pgfault": 4185, "total_pgmajfault": 0, "total_pgpgin": 2926, "total_pgpgout": 2778, "total_rss": 606208, "total_rss_huge": 0, "total_unevictable": 0, "total_writeback": 0, "unevictable": 0, "writeback": 0 }, "limit": 134217728 }, "name": "/ecs-curltest-26-curl-c2e5f6e0cf91b0bead01", "id": "5fc21e5b015f899d22618f8aede80b6d70d71b2a75465ea49d9462c8f3d2d3af", "networks": { "eth0": { "rx_bytes": 84, "rx_packets": 2, "rx_errors": 0, "rx_dropped": 0, "tx_bytes": 84, "tx_packets": 2, "tx_errors": 0, "tx_dropped": 0 } }, "network_rate_stats": { "rx_bytes_per_sec": 0, "tx_bytes_per_sec": 0 } } ``` ## Ejemplo de respuesta de estadísticas de las tareas Cuando se consulta el punto de enlace `${ECS_CONTAINER_METADATA_URI_V4}/task/stats`, se devuelven las métricas de red relacionadas con la tarea de la que forma parte el contenedor. El siguiente es un ejemplo de salida. ``` { "01999f2e5c6cf4df3873f28950e6278813408f281c54778efec860d0caad4854": { "read": "2020-10-02T00:51:32.51467703Z", "preread": "2020-10-02T00:51:31.50860463Z", "pids_stats": { "current": 1 }, "blkio_stats": { "io_service_bytes_recursive": [ ], "io_serviced_recursive": [ ], "io_queue_recursive": [ ], "io_service_time_recursive": [ ], "io_wait_time_recursive": [ ], "io_merged_recursive": [ ], "io_time_recursive": [ ], "sectors_recursive": [ ] }, "num_procs": 0, "storage_stats": { }, "cpu_stats": { "cpu_usage": { "total_usage": 177232665, "percpu_usage": [ 13376224, 163856441 ], "usage_in_kernelmode": 0, "usage_in_usermode": 160000000 }, "system_cpu_usage": 13977820000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "precpu_stats": { "cpu_usage": { "total_usage": 177232665, "percpu_usage": [ 13376224, 163856441 ], "usage_in_kernelmode": 0, "usage_in_usermode": 160000000 }, "system_cpu_usage": 13975800000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "memory_stats": { "usage": 532480, "max_usage": 6279168, "stats": { "active_anon": 40960, "active_file": 0, "cache": 0, "dirty": 0, "hierarchical_memory_limit": 9223372036854771712, "hierarchical_memsw_limit": 9223372036854771712, "inactive_anon": 0, "inactive_file": 0, "mapped_file": 0, "pgfault": 2033, "pgmajfault": 0, "pgpgin": 1734, "pgpgout": 1724, "rss": 40960, "rss_huge": 0, "total_active_anon": 40960, "total_active_file": 0, "total_cache": 0, "total_dirty": 0, "total_inactive_anon": 0, "total_inactive_file": 0, "total_mapped_file": 0, "total_pgfault": 2033, "total_pgmajfault": 0, "total_pgpgin": 1734, "total_pgpgout": 1724, "total_rss": 40960, "total_rss_huge": 0, "total_unevictable": 0, "total_writeback": 0, "unevictable": 0, "writeback": 0 }, "limit": 4073377792 }, "name": "/ecs-curltest-26-internalecspause-a6bcc3dbadfacfe85300", "id": "01999f2e5c6cf4df3873f28950e6278813408f281c54778efec860d0caad4854", "networks": { "eth0": { "rx_bytes": 84, "rx_packets": 2, "rx_errors": 0, "rx_dropped": 0, "tx_bytes": 84, "tx_packets": 2, "tx_errors": 0, "tx_dropped": 0 } }, "network_rate_stats": { "rx_bytes_per_sec": 0, "tx_bytes_per_sec": 0 } }, "5fc21e5b015f899d22618f8aede80b6d70d71b2a75465ea49d9462c8f3d2d3af": { "read": "2020-10-02T00:51:32.512771349Z", "preread": "2020-10-02T00:51:31.510597736Z", "pids_stats": { "current": 3 }, "blkio_stats": { "io_service_bytes_recursive": [ ], "io_serviced_recursive": [ ], "io_queue_recursive": [ ], "io_service_time_recursive": [ ], "io_wait_time_recursive": [ ], "io_merged_recursive": [ ], "io_time_recursive": [ ], "sectors_recursive": [ ] }, "num_procs": 0, "storage_stats": { }, "cpu_stats": { "cpu_usage": { "total_usage": 379075681, "percpu_usage": [ 191355275, 187720406 ], "usage_in_kernelmode": 60000000, "usage_in_usermode": 310000000 }, "system_cpu_usage": 13977800000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "precpu_stats": { "cpu_usage": { "total_usage": 378825197, "percpu_usage": [ 191104791, 187720406 ], "usage_in_kernelmode": 60000000, "usage_in_usermode": 310000000 }, "system_cpu_usage": 13975800000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "memory_stats": { "usage": 1814528, "max_usage": 6299648, "stats": { "active_anon": 606208, "active_file": 0, "cache": 0, "dirty": 0, "hierarchical_memory_limit": 134217728, "hierarchical_memsw_limit": 268435456, "inactive_anon": 0, "inactive_file": 0, "mapped_file": 0, "pgfault": 5377, "pgmajfault": 0, "pgpgin": 3613, "pgpgout": 3465, "rss": 606208, "rss_huge": 0, "total_active_anon": 606208, "total_active_file": 0, "total_cache": 0, "total_dirty": 0, "total_inactive_anon": 0, "total_inactive_file": 0, "total_mapped_file": 0, "total_pgfault": 5377, "total_pgmajfault": 0, "total_pgpgin": 3613, "total_pgpgout": 3465, "total_rss": 606208, "total_rss_huge": 0, "total_unevictable": 0, "total_writeback": 0, "unevictable": 0, "writeback": 0 }, "limit": 134217728 }, "name": "/ecs-curltest-26-curl-c2e5f6e0cf91b0bead01", "id": "5fc21e5b015f899d22618f8aede80b6d70d71b2a75465ea49d9462c8f3d2d3af", "networks": { "eth0": { "rx_bytes": 84, "rx_packets": 2, "rx_errors": 0, "rx_dropped": 0, "tx_bytes": 84, "tx_packets": 2, "tx_errors": 0, "tx_dropped": 0 } }, "network_rate_stats": { "rx_bytes_per_sec": 0, "tx_bytes_per_sec": 0 } } } ``` # 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](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 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. # Respuesta JSON para la versión 3 de los metadatos de tareas de Amazon ECS La siguiente información se devuelve desde la respuesta de JSON (`${ECS_CONTAINER_METADATA_URI}/task`) de punto de enlace de metadatos de tarea. `Cluster` El nombre de recurso de Amazon (ARN) o el nombre corto del clúster de Amazon ECS al que pertenece la tarea. `TaskARN` Nombre de recurso de Amazon (ARN) de la tarea al que pertenece el contenedor. `Family` La familia de la definición de tareas de Amazon ECS para la tarea. `Revision` La revisión de la definición de tareas de Amazon ECS para la tarea. `DesiredStatus` El estado deseado para la tarea de Amazon ECS. `KnownStatus` El estado conocido para la tarea de Amazon ECS. `Limits` Los límites de recursos especificados en el nivel de tarea, por ejemplo, CPU (expresado en vCPU) y memoria. Este parámetro se omite si no se definen límites de recurso. `PullStartedAt` La marca temporal del momento en que comenzó la primera extracción de la imagen del contenedor. `PullStoppedAt` La marca temporal del momento en que finalizó la última extracción de la imagen del contenedor. `AvailabilityZone` La zona de disponibilidad donde está la tarea. Los metadatos de la zona de disponibilidad solo están disponibles para las tareas de Fargate que utilicen la versión 1.4 o posterior (Linux) o 1.0.0 o posterior (Windows) de la plataforma. `Containers` Una lista de metadatos de contenedor para cada contenedor asociado con la tarea. `DockerId` El ID de Docker para el contenedor. `Name` El nombre del contenedor tal y como se especifica en la definición de tarea. `DockerName` El nombre del contenedor suministrado a Docker. El agente de contenedor de Amazon ECS genera un nombre único para el contenedor a fin de evitar conflictos de nombre cuando se ejecutan en una sola instancia varias copias de la misma definición de tareas. `Image` La imagen para el contenedor. `ImageID` El resumen SHA-256 del manifiesto de la imagen. Este es el resumen que se puede usar para extraer la imagen utilizando el formato `repository-url/image@sha256:digest`. `Ports` Los puertos expuestos para el contenedor. Este parámetro se omite si no hay puertos expuestos. `Labels` Cualquier etiqueta aplicada al contenedor. Este parámetro se omite si no hay etiquetas aplicadas. `DesiredStatus` El estado deseado para el contenedor procedente de Amazon ECS. `KnownStatus` El estado conocido para el contenedor procedente de Amazon ECS. `ExitCode` El código de salida para el contenedor. Este parámetro se omite si el contenedor no ha salido. `Limits` Los límites de recursos especificados en el nivel de contenedor, por ejemplo, CPU (expresado en unidades de CPU) y memoria. Este parámetro se omite si no se definen límites de recurso. `CreatedAt` La marca de hora para cuando el contenedor se creó. Este parámetro se omite si el contenedor no ha se ha creado aún. `StartedAt` La marca de hora para cuando el contenedor se inició. Este parámetro se omite si el contenedor no ha se ha iniciado aún. `FinishedAt` La marca de hora para cuando el contenedor se detuvo. Este parámetro se omite si el contenedor no ha se ha detenido aún. `Type` El tipo del contenedor. Los contenedores que se especifican en su definición de tarea son de tipo `NORMAL`. Puede hacer caso omiso de otros tipos de contenedores que utiliza el agente de contenedor de Amazon ECS para el aprovisionamiento de recursos para tareas internas. `Networks` La información de red del contenedor, como la dirección IP y el modo de red. Este parámetro se omite si no se define ninguna información de red. `ClockDrift` La información sobre la diferencia entre la hora de referencia y la hora del sistema. Esto se aplica al sistema operativo Linux. Esta capacidad utiliza el Servicio de sincronización temporal de Amazon para medir la precisión del reloj y proporcionar el límite de error de reloj de los contenedores. Para más información, consulte [Set the time for your Linux instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html) en la *Guía del usuario de Amazon EC2 para instancias de Linux*. `ReferenceTime` La base de la precisión del reloj. Amazon ECS utiliza el estándar global de hora universal coordinada (UTC) a través de NTP, por ejemplo `2021-09-07T16:57:44Z`. `ClockErrorBound` La medida del error de reloj, definida como el desplazamiento a UTC. Este error es la diferencia en milisegundos entre la hora de referencia y la hora del sistema. `ClockSynchronizationStatus` Indica si el intento de sincronización más reciente entre la hora del sistema y la hora de referencia se ha realizado correctamente. Los valores válidos son `SYNCHRONIZED` y ` NOT_SYNCHRONIZED`. `ExecutionStoppedAt` La marca temporal para cuando el `DesiredStatus` de la tarea pasó a `STOPPED`. Esto ocurre cuando un contenedor esencial pasa a `STOPPED`. # Ejemplos de la versión 3 de los metadatos de tareas de Amazon ECS En los siguientes ejemplos se muestran resultados de ejemplo de los puntos de enlace de metadatos de tareas. ## Ejemplo de respuesta de metadatos de contenedor Cuando se consulta el punto de enlace `${ECS_CONTAINER_METADATA_URI}`, solo se devuelven los metadatos relacionados con el propio contenedor. El siguiente es un ejemplo de salida. ``` { "DockerId": "43481a6ce4842eec8fe72fc28500c6b52edcc0917f105b83379f88cac1ff3946", "Name": "nginx-curl", "DockerName": "ecs-nginx-5-nginx-curl-ccccb9f49db0dfe0d901", "Image": "nrdlngr/nginx-curl", "ImageID": "sha256:2e00ae64383cfc865ba0a2ba37f61b50a120d2d9378559dcd458dc0de47bc165", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "nginx-curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "com.amazonaws.ecs.task-definition-family": "nginx", "com.amazonaws.ecs.task-definition-version": "5" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 512, "Memory": 512 }, "CreatedAt": "2018-02-01T20:55:10.554941919Z", "StartedAt": "2018-02-01T20:55:11.064236631Z", "Type": "NORMAL", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.106" ] } ] } ``` ## Ejemplo de respuesta de metadatos de las tareas Cuando se consulta el punto de enlace `${ECS_CONTAINER_METADATA_URI}/task`, se devuelven los metadatos relacionados con la tarea de la que forma parte el contenedor. El siguiente es un ejemplo de salida. La siguiente respuesta JSON es para una tarea de contenedor único. ``` { "Cluster": "default", "TaskARN": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "Family": "nginx", "Revision": "5", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Containers": [ { "DockerId": "731a0d6a3b4210e2448339bc7015aaa79bfe4fa256384f4102db86ef94cbbc4c", "Name": "~internal~ecs~pause", "DockerName": "ecs-nginx-5-internalecspause-acc699c0cbf2d6d11700", "Image": "amazon/amazon-ecs-pause:0.1.0", "ImageID": "", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "~internal~ecs~pause", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "com.amazonaws.ecs.task-definition-family": "nginx", "com.amazonaws.ecs.task-definition-version": "5" }, "DesiredStatus": "RESOURCES_PROVISIONED", "KnownStatus": "RESOURCES_PROVISIONED", "Limits": { "CPU": 0, "Memory": 0 }, "CreatedAt": "2018-02-01T20:55:08.366329616Z", "StartedAt": "2018-02-01T20:55:09.058354915Z", "Type": "CNI_PAUSE", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.106" ] } ] }, { "DockerId": "43481a6ce4842eec8fe72fc28500c6b52edcc0917f105b83379f88cac1ff3946", "Name": "nginx-curl", "DockerName": "ecs-nginx-5-nginx-curl-ccccb9f49db0dfe0d901", "Image": "nrdlngr/nginx-curl", "ImageID": "sha256:2e00ae64383cfc865ba0a2ba37f61b50a120d2d9378559dcd458dc0de47bc165", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "nginx-curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "com.amazonaws.ecs.task-definition-family": "nginx", "com.amazonaws.ecs.task-definition-version": "5" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 512, "Memory": 512 }, "CreatedAt": "2018-02-01T20:55:10.554941919Z", "StartedAt": "2018-02-01T20:55:11.064236631Z", "Type": "NORMAL", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.106" ] } ] } ], "PullStartedAt": "2018-02-01T20:55:09.372495529Z", "PullStoppedAt": "2018-02-01T20:55:10.552018345Z", "AvailabilityZone": "us-east-2b" } ``` # Versión 2 del punto de conexión de los metadatos de tareas de Amazon ECS **importante** El punto de conexión de la versión 2 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). A partir de la versión 1.17.0 del agente de contenedor de Amazon ECS, 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 que utilizan el modo de red `awsvpc` en un punto de enlace HTTP proporcionado por el agente de contenedor de Amazon ECS. Todos los contenedores que pertenecen a las tareas que se lanzaron con el modo de red `awsvpc` reciben una dirección IPv4 local dentro de un rango de direcciones local de enlace predefinido. Cuando un contenedor consulta el punto de enlace de metadatos, el agente de contenedor de Amazon ECS determina a qué tarea pertenece el contenedor en función de su dirección IP única y de los metadatos y estadísticas que se muestran para dicha tarea. ## Habilitación de metadatos de tareas **importante** El punto de conexión de la versión 2 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). A partir de la versión 1.17.0 del agente de contenedor de Amazon ECS, 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 que utilizan el modo de red `awsvpc` en un punto de enlace HTTP proporcionado por el agente de contenedor de Amazon ECS. Todos los contenedores que pertenecen a las tareas que se lanzaron con el modo de red `awsvpc` reciben una dirección IPv4 local dentro de un rango de direcciones local de enlace predefinido. Cuando un contenedor consulta el punto de enlace de metadatos, el agente de contenedor de Amazon ECS determina a qué tarea pertenece el contenedor en función de su dirección IP única y de los metadatos y estadísticas que se muestran para dicha tarea. ### Habilitación de metadatos de tareas La característica de versión 2 de metadatos de tarea está habilitada de forma predeterminada para lo siguiente: + Tareas que utilizan Fargate y la versión de la plataforma v1.1.0 o posterior. Para obtener más información, consulte [Versiones de la plataforma Fargate para Amazon ECS](platform-fargate.md). + Tareas que utilizan EC2 y que también utilizan el modo de red `awsvpc` y se lanzan en una infraestructura de Linux de Amazon EC2 que usa la versión 1.17.0 del agente de contenedor de Amazon ECS como mínimo o en una infraestructura de Windows de Amazon EC2 que usa la versión `1.54.0` del agente de contenedor de Amazon ECS como mínimo. 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). ### Rutas de punto de enlace de metadatos de tareas Los siguientes puntos de enlace de API están disponibles para los contenedores: `169.254.170.2/v2/metadata` Este punto de enlace devuelve metadatos JSON 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 de metadatos de tareas](#task-metadata-endpoint-v2-response). `169.254.170.2/v2/metadata/` Este punto de enlace devuelve metadatos JSON para el ID de contenedor de Docker especificado. `169.254.170.2/v2/metadata/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`. `169.254.170.2/v2/stats` Este punto de enlace 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. `169.254.170.2/v2/stats/` Este punto de enlace devuelve JSON de estadísticas de Docker para el ID de contenedor de Docker especificado. 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. ### Respuesta JSON de metadatos de tareas La siguiente información se devuelve desde la respuesta de JSON (`169.254.170.2/v2/metadata`) de punto de enlace de metadatos de tarea. `Cluster` El nombre de recurso de Amazon (ARN) o el nombre corto del clúster de Amazon ECS al que pertenece la tarea. `TaskARN` Nombre de recurso de Amazon (ARN) de la tarea al que pertenece el contenedor. `Family` La familia de la definición de tareas de Amazon ECS para la tarea. `Revision` La revisión de la definición de tareas de Amazon ECS para la tarea. `DesiredStatus` El estado deseado para la tarea de Amazon ECS. `KnownStatus` El estado conocido para la tarea de Amazon ECS. `Limits` Los límites de recursos especificados en el nivel de tarea, por ejemplo, CPU (expresado en vCPU) y memoria. Este parámetro se omite si no se definen límites de recurso. `PullStartedAt` La marca temporal del momento en que comenzó la primera extracción de la imagen del contenedor. `PullStoppedAt` La marca temporal del momento en que finalizó la última extracción de la imagen del contenedor. `AvailabilityZone` La zona de disponibilidad donde está la tarea. Los metadatos de la zona de disponibilidad solo están disponibles para las tareas de Fargate que utilicen la versión 1.4 o posterior (Linux) o 1.0.0 o posterior (Windows) de la plataforma. `Containers` Una lista de metadatos de contenedor para cada contenedor asociado con la tarea. `DockerId` El ID de Docker para el contenedor. `Name` El nombre del contenedor tal y como se especifica en la definición de tarea. `DockerName` El nombre del contenedor suministrado a Docker. El agente de contenedor de Amazon ECS genera un nombre único para el contenedor a fin de evitar conflictos de nombre cuando se ejecutan en una sola instancia varias copias de la misma definición de tareas. `Image` La imagen para el contenedor. `ImageID` El resumen SHA-256 del manifiesto de la imagen. Este es el resumen que se puede usar para extraer la imagen utilizando el formato `repository-url/image@sha256:digest`. `Ports` Los puertos expuestos para el contenedor. Este parámetro se omite si no hay puertos expuestos. `Labels` Cualquier etiqueta aplicada al contenedor. Este parámetro se omite si no hay etiquetas aplicadas. `DesiredStatus` El estado deseado para el contenedor procedente de Amazon ECS. `KnownStatus` El estado conocido para el contenedor procedente de Amazon ECS. `ExitCode` El código de salida para el contenedor. Este parámetro se omite si el contenedor no ha salido. `Limits` Los límites de recursos especificados en el nivel de contenedor, por ejemplo, CPU (expresado en unidades de CPU) y memoria. Este parámetro se omite si no se definen límites de recurso. `CreatedAt` La marca de hora para cuando el contenedor se creó. Este parámetro se omite si el contenedor no ha se ha creado aún. `StartedAt` La marca de hora para cuando el contenedor se inició. Este parámetro se omite si el contenedor no ha se ha iniciado aún. `FinishedAt` La marca de hora para cuando el contenedor se detuvo. Este parámetro se omite si el contenedor no ha se ha detenido aún. `Type` El tipo del contenedor. Los contenedores que se especifican en su definición de tarea son de tipo `NORMAL`. Puede hacer caso omiso de otros tipos de contenedores que utiliza el agente de contenedor de Amazon ECS para el aprovisionamiento de recursos para tareas internas. `Networks` La información de red del contenedor, como la dirección IP y el modo de red. Este parámetro se omite si no se define ninguna información de red. `ClockDrift` La información sobre la diferencia entre la hora de referencia y la hora del sistema. Esto se aplica al sistema operativo Linux. Esta capacidad utiliza el Servicio de sincronización temporal de Amazon para medir la precisión del reloj y proporcionar el límite de error de reloj de los contenedores. Para más información, consulte [Set the time for your Linux instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html) en la *Guía del usuario de Amazon EC2 para instancias de Linux*. `ReferenceTime` La base de la precisión del reloj. Amazon ECS utiliza el estándar global de hora universal coordinada (UTC) a través de NTP, por ejemplo `2021-09-07T16:57:44Z`. `ClockErrorBound` La medida del error de reloj, definida como el desplazamiento a UTC. Este error es la diferencia en milisegundos entre la hora de referencia y la hora del sistema. `ClockSynchronizationStatus` Indica si el intento de sincronización más reciente entre la hora del sistema y la hora de referencia se ha realizado correctamente. Los valores válidos son `SYNCHRONIZED` y ` NOT_SYNCHRONIZED`. `ExecutionStoppedAt` La marca temporal para cuando el `DesiredStatus` de la tarea pasó a `STOPPED`. Esto ocurre cuando un contenedor esencial pasa a `STOPPED`. ### Ejemplo de respuesta de metadatos de las tareas La siguiente respuesta JSON es para una tarea de contenedor único. ``` { "Cluster": "default", "TaskARN": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "Family": "nginx", "Revision": "5", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Containers": [ { "DockerId": "731a0d6a3b4210e2448339bc7015aaa79bfe4fa256384f4102db86ef94cbbc4c", "Name": "~internal~ecs~pause", "DockerName": "ecs-nginx-5-internalecspause-acc699c0cbf2d6d11700", "Image": "amazon/amazon-ecs-pause:0.1.0", "ImageID": "", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "~internal~ecs~pause", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "com.amazonaws.ecs.task-definition-family": "nginx", "com.amazonaws.ecs.task-definition-version": "5" }, "DesiredStatus": "RESOURCES_PROVISIONED", "KnownStatus": "RESOURCES_PROVISIONED", "Limits": { "CPU": 0, "Memory": 0 }, "CreatedAt": "2018-02-01T20:55:08.366329616Z", "StartedAt": "2018-02-01T20:55:09.058354915Z", "Type": "CNI_PAUSE", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.106" ] } ] }, { "DockerId": "43481a6ce4842eec8fe72fc28500c6b52edcc0917f105b83379f88cac1ff3946", "Name": "nginx-curl", "DockerName": "ecs-nginx-5-nginx-curl-ccccb9f49db0dfe0d901", "Image": "nrdlngr/nginx-curl", "ImageID": "sha256:2e00ae64383cfc865ba0a2ba37f61b50a120d2d9378559dcd458dc0de47bc165", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "nginx-curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "com.amazonaws.ecs.task-definition-family": "nginx", "com.amazonaws.ecs.task-definition-version": "5" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 512, "Memory": 512 }, "CreatedAt": "2018-02-01T20:55:10.554941919Z", "StartedAt": "2018-02-01T20:55:11.064236631Z", "Type": "NORMAL", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.106" ] } ] } ], "PullStartedAt": "2018-02-01T20:55:09.372495529Z", "PullStoppedAt": "2018-02-01T20:55:10.552018345Z", "AvailabilityZone": "us-east-2b" } ```