# Endpoint de metadados de tarefas do Amazon ECS versão 3
<a name="task-metadata-endpoint-v3"></a>

**Importante**  
O endpoint da versão 3 dos metadados da tarefa não está mais sendo mantido ativamente. Recomendamos que você atualize o endpoint versão 4 de metadados da tarefa para obter as informações mais recentes do endpoint de metadados. Para obter mais informações, consulte [Endpoint de metadados de tarefas do Amazon ECS versão 4](task-metadata-endpoint-v4.md).  
Se você estiver usando tarefas do Amazon ECS hospedadas no AWS Fargate, consulte [Endpoint de metadados de tarefas do Amazon ECS versão 3 para tarefas no Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v3-fargate.html).

A partir da versão 1.21.0 do agente de contêineres do Amazon ECS, o agente injeta uma variável de ambiente denominada `ECS_CONTAINER_METADATA_URI` em cada contêiner de uma tarefa. Quando você consultar o endpoint de metadados de tarefas versão 3, vários metadados de tarefas e [estatísticas do Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) estarão disponíveis para tarefas. Para tarefas que usam o modo de rede `bridge`, as métricas de rede estão disponíveis ao consultar os endpoints `/stats`.

O recurso de endpoint de metadados de tarefas versão 3 é habilitado por padrão para tarefas que usam o Fargate na versão v1.3.0 ou posterior da plataforma e tarefas que usam o EC2 e são inicializadas na infraestrutura do Linux do Amazon EC2 executando pelo menos a versão 1.21.0 do agente de contêiner do Amazon ECS ou na infraestrutura do Windows do Amazon EC2 executando pelo menos a versão `1.54.0` do agente de contêiner do Amazon ECS e usam o modo de rede `awsvpc`. Para obter mais informações, consulte [Gerenciamento de instâncias de contêiner do Linux no Amazon ECS](manage-linux.md).

É possível adicionar suporte a esse recurso nas instâncias de contêiner mais antigas atualizando o agente para a versão mais recente. Para obter mais informações, consulte [Atualizar o agente de contêiner do Amazon ECS](ecs-agent-update.md).

**Importante**  
Para tarefas que usam o Fargate e versões de plataforma anteriores à v1.3.0, não há suporte para o endpoint de metadados de tarefas versão 2. Para obter mais informações, consulte [Endpoint de metadados de tarefas do Amazon ECS versão 2](task-metadata-endpoint-v2.md).

## Caminhos do endpoint de metadados de tarefas versão 3
<a name="task-metadata-endpoint-v3-paths"></a>

Os seguintes endpoints de metadados de tarefas estão disponíveis para os contêineres:

`${ECS_CONTAINER_METADATA_URI}`  
Esse caminho retorna o JSON de metadados para o contêiner.

`${ECS_CONTAINER_METADATA_URI}/task`  
Esse caminho retorna o JSON de metadados para a tarefa, incluindo uma lista dos nomes e IDs de todos os contêineres associados à tarefa. Para obter mais informações sobre a resposta para esse endpoint, consulte [Resposta JSON para metadados de tarefas v3 no Amazon ECS](task-metadata-endpoint-v3-response.md).

`${ECS_CONTAINER_METADATA_URI}/taskWithTags`  
Esse caminho retorna os metadados para a tarefa incluída no endpoint `/task` além das etiquetas de tarefa e de instância de contêiner que podem ser recuperadas usando a API `ListTagsForResource`. 

`${ECS_CONTAINER_METADATA_URI}/stats`  
Esse caminho retorna o JSON de estatísticas do Docker para o contêiner do Docker específico. Para obter mais informações sobre cada uma das estatísticas retornadas, consulte [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) na documentação da API do Docker.

`${ECS_CONTAINER_METADATA_URI}/task/stats`  
Esse caminho retorna o JSON de estatísticas do Docker para todos os contêineres associados à tarefa. Para obter mais informações sobre cada uma das estatísticas retornadas, consulte [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) na documentação da API do Docker.