Endpoint de metadados de tarefas do Amazon ECS versão 3 - Amazon Elastic Container Service
Caminhos do endpoint de metadados de tarefas versão 3

Endpoint de metadados de tarefas do Amazon ECS versão 3

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 ter mais informações, consulte Endpoint de metadados de tarefas do Amazon ECS versão 4.

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.

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 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 tipo de inicialização do Fargate na versão v1.3.0 ou posterior da plataforma e tarefas que usam o tipo de inicialização do EC2 e são iniciadas 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 usa o modo de rede awsvpc. Para ter mais informações, consulte Gerenciamento de instâncias de contêiner do Linux no Amazon ECS.

É 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 ter mais informações, consulte Atualizar o agente de contêiner do Amazon ECS.

Importante

Para tarefas que usam o tipo de execução do Fargate e versões anteriores à v1.3.0 da plataforma, a versão 2 do endpoint de metadados de tarefas é compatível. Para ter mais informações, consulte Endpoint de metadados de tarefas do Amazon ECS versão 2.

Caminhos do endpoint de metadados de tarefas versão 3

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.

${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 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 na documentação da API do Docker.