

# Metadados de tarefas disponíveis para tarefas do Amazon ECS no EC2
<a name="ec2-metadata"></a>

O agente de contêiner do Amazon ECS fornece um método para recuperar diversos metadados de tarefas e [dados estatísticos do Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats). Isso é chamado de endpoint de metadados de tarefas. As seguintes versões estão disponíveis:
+ Endpoint de metadados de tarefas versão 4: fornece uma variedade de metadados e dados estatísticos do Docker para contêineres. Também pode fornecer dados de taxa de rede. Disponível para tarefas do Amazon ECS inicializadas em instâncias Linux do Amazon EC2 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 [Endpoint de metadados de tarefas do Amazon ECS versão 4](task-metadata-endpoint-v4.md).
+ Endpoint de metadados de tarefas versão 3: fornece uma variedade de metadados e dados estatísticos do Docker para contêineres. Disponível para tarefas do Amazon ECS inicializadas em instâncias Linux do Amazon EC2 executando pelo menos a versão `1.21.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 [Endpoint de metadados de tarefas do Amazon ECS versão 3](task-metadata-endpoint-v3.md).
+ Endpoint de metadados de tarefas versão 2: disponível para tarefas do Amazon ECS inicializadas em instâncias Linux do Amazon EC2 executando pelo menos a versão `1.17.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 [Endpoint de metadados de tarefas do Amazon ECS versão 2](task-metadata-endpoint-v2.md).

 Se sua tarefa do Amazon ECS estiver hospedada no Amazon EC2 ou se ela usar o modo de rede `host` e estiver hospedada nas instâncias gerenciadas do Amazon ECS, você também poderá acessar os metadados do host de tarefas usando o [endpoint do serviço de metadados de instância (IMDS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html)). O comando a seguir, quando executado de dentro da instância que hospeda a tarefa, lista o ID da instância host. 

```
 curl http://169.254.169.254/latest/meta-data/{{instance-id}}
```

Se sua tarefa do Amazon ECS estiver hospedada no Amazon EC2 e em uma configuração somente IPv6, você poderá acessar os metadados do host de tarefas usando o endpoint IMDS IPv6. O comando a seguir, quando executado de dentro da instância que hospeda a tarefa, lista o ID da instância host sobre IPv6.

```
 curl http://[fd00:ec2::254]/latest/meta-data/{{instance-id}}
```

Para acessar o endpoint IMDS IPv6, habilite-o em sua instância de contêiner e também configure como `IPv6` o modo de endpoint do serviço de metadados usando o provedor de credenciais IMDS do SDK escolhido. Para obter mais informações sobre como habilitar o endpoint IMDS IPv6 para sua instância de contêiner, consulte [Configurar as opções do serviço de metadados de instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html) no *Guia do usuário do Amazon EC2*. Para obter mais informações sobre o provedor de credenciais IMDS para SDKs, consulte [Provedor de credenciais IMDS](https://docs.aws.amazon.com/sdkref/latest/guide/feature-imds-credentials.html) no *Guia de referência de SDKs e ferramentas da AWS*.

**nota**  
O endpoint IMDS IPv6 não está acessível quando a configuração da conta `awsvpcTrunking` está habilitada. Para acessar as credenciais do perfil do IAM da instância de contêiner quando `awsvpcTrunking` está habilitado, você pode usar um perfil do IAM de tarefa em vez disso. Para obter mais informações sobre perfis do IAM de tarefa, consulte [Perfil do IAM para tarefas do Amazon ECS](task-iam-roles.md).

 As informações que podem ser obtidas do endpoint são divididas em categorias, como `{{instance-id}}`. Para obter mais informações sobre as diferentes categorias de metadados da instância hospedeira que podem ser obtidas usando o endpoint, consulte [Categorias de metadados da instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html#instancedata-data-categories).