# Endpoint de metadados de tarefas do Amazon ECS versão 4 para tarefas no Fargate
<a name="task-metadata-endpoint-v4-fargate"></a>

**Importante**  
Se estiver usando tarefas do Amazon ECS hospedadas em instâncias do Amazon EC2, consulte [Amazon ECS task metadata endpoint](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint.html).

Começando com a versão `1.4.0` da plataforma do Fargate, uma variável de ambiente denominada `ECS_CONTAINER_METADATA_URI_V4` é injetada em cada contêiner de uma tarefa. Quando você consulta o endpoint de metadados de tarefas versão 4, vários metadados de tarefas e [dados estatísticos do Docker](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats) estão disponíveis para tarefas.

O endpoint de metadados de tarefas versão 4 funciona como o endpoint versão 3, mas fornece metadados de rede adicionais para contêineres e tarefas. Métricas de rede adicionais também estão disponíveis ao consultar os endpoints `/stats`.

O endpoint de metadados de tarefa é ativado por padrão para todas as tarefas do Amazon ECS executadas no AWS Fargate que usam a versão `1.4.0` ou posterior da plataforma.

**nota**  
Para evitar a necessidade de criar novas versões de endpoint de metadados de tarefas no futuro, os metadados adicionais podem ser adicionados à saída da versão 4. Não removeremos quaisquer metadados existentes nem alteraremos os nomes dos campos de metadados.

## Caminhos do endpoint de metadados de tarefas do Fargate versão 4
<a name="task-metadata-endpoint-v4-fargate-paths"></a>

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

`${ECS_CONTAINER_METADATA_URI_V4}`  
Esse caminho retorna metadados para o contêiner.

`${ECS_CONTAINER_METADATA_URI_V4}/task`  
Esse caminho retorna 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 v4 no Amazon ECS para tarefas no Fargate](task-metadata-endpoint-v4-fargate-response.md).

`${ECS_CONTAINER_METADATA_URI_V4}/stats`  
Esse caminho retorna dados estatísticos do Docker para o contêiner do Docker. Para obter mais informações sobre cada uma das estatísticas retornadas, consulte [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats) na documentação da API do Docker.  
Tarefas do Amazon ECS no AWS Fargate exigem que o contêiner seja executado por \~1 segundo antes de retornar os dados estatísticos do contêiner.

`${ECS_CONTAINER_METADATA_URI_V4}/task/stats`  
Esse caminho retorna os dados estatísticos 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/engine/api/v1.30/#operation/ContainerStats) na documentação da API do Docker.  
Tarefas do Amazon ECS no AWS Fargate exigem que o contêiner seja executado por \~1 segundo antes de retornar os dados estatísticos do contêiner.