# Endpoint de metadados de tarefas do Amazon ECS versão 4
O agente de contêiner do Amazon ECS injeta uma variável de ambiente em cada contêiner, conhecida como *endpoint de metadados de tarefas*, que fornece vários metadados de tarefas e [dados estatísticos do Docker](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats) ao contêiner.
Os metadados de tarefas os dados estatísticos de taxa de rede são enviados para o CloudWatch Container Insights e podem ser visualizados no Console de gerenciamento da AWS. Para obter mais informações, consulte [Monitorar contêineres do Amazon ECS utilizando o Container Insights com observabilidade aprimorada](cloudwatch-container-insights.md).
**nota**
O Amazon ECS fornece versões anteriores do endpoint de metadados de tarefas. 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.
A variável de ambiente é injetada por padrão nos contêineres das tarefas do Amazon ECS inicializadas em instâncias do Linux do Amazon EC2 que estão executando pelo menos a versão `1.39.0` do agente de contêiner do Amazon ECS. Para instâncias do Windows do Amazon EC2 que usam o modo de rede `awsvpc`, o agente de contêiner do Amazon ECS deve ter pelo menos a versão `1.54.0`. Para obter mais informações, consulte [Gerenciamento de instâncias de contêiner do Linux no Amazon ECS](manage-linux.md).
**nota**
É possível adicionar suporte a esse recurso em instâncias do Amazon EC2 usando versões mais antigas do agente de contêiner do Amazon ECS 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).
Para obter exemplos de saída de metadados de tarefas, consulte [Exemplos de metadados de tarefas v4 no Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v4-examples.html).
## Caminhos do endpoint de metadados de tarefas versão 4
Os seguintes caminhos de endpoints de metadados de tarefas estão disponíveis para 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](task-metadata-endpoint-v4-response.md).
`${ECS_CONTAINER_METADATA_URI_V4}/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`. Todos os erros recebidos ao serem recuperados os metadados da etiqueta serão incluídos no campo `Errors` da resposta.
O campo `Errors` existe apenas na resposta para tarefas hospedadas em instâncias do Linux do Amazon EC2 executando pelo menos a versão `1.50.0` do agente de contêiner. Para instâncias do Windows do Amazon EC2 que usam o modo de rede `awsvpc`, o agente de contêiner do Amazon ECS deve ter pelo menos a versão `1.54.0`
Esse endpoint requer a permissão `ecs.ListTagsForResource`.
Ao usar o endpoint `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags`, esteja ciente de que cada chamada faz até duas solicitações de API para `ecs:ListTagsForResource` (uma para tags de instâncias de contêineres e outra para tags de tarefas) e que qualquer contêiner sidecar na tarefa pode fazer essas chamadas em seu nome. Chamadas frequentes de endpoint podem resultar no controle de utilização de API.
Considere implementar estratégias de armazenamento em cache ou de processamento em lote para reduzir a frequência das chamadas, especialmente em aplicações de alto tráfego, e depurar problemas de controle de utilização de API usando o AWS CloudTrail. Para obter informações sobre os limites de controles de utilização para a API `ListTagsForResource`, consulte [Request throttling for the Amazon ECS API](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/request-throttling.html) na *Referência de APIs do Amazon Elastic Container Service*. Para obter informações sobre como depurar chamadas de API do Amazon ECS usando o AWS CloudTrail, consulte [Registro em log das chamadas de API do Amazon ECS usando o AWS CloudTrail](logging-using-cloudtrail.md).
`${ECS_CONTAINER_METADATA_URI_V4}/stats`
Esse caminho retorna dados estatísticos do Docker para o contêiner específico. 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.
Para tarefas do Amazon ECS que usam o modo de rede `awsvpc` ou `bridge` hospedado em instâncias do Linux do Amazon EC2 executando pelo menos a versão `1.43.0` do agente de contêiner, haverá dados estatísticos adicionais de taxa de rede incluídos na resposta. Para todas as outras tarefas, a resposta só incluirá os dados estatísticos de rede cumulativos.
`${ECS_CONTAINER_METADATA_URI_V4}/task/stats`
Esse caminho retorna os dados estatísticos do Docker para todos os contêineres associados à tarefa. Isso pode ser usado por contêineres de arquivos associados para extrair métricas de rede. 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.
Para tarefas do Amazon ECS que usam o modo de rede `awsvpc` ou `bridge` hospedado em instâncias do Linux do Amazon EC2 executando pelo menos a versão `1.43.0` do agente de contêiner, haverá dados estatísticos adicionais de taxa de rede incluídos na resposta. Para todas as outras tarefas, a resposta só incluirá os dados estatísticos de rede cumulativos.