# Arquivo de metadados de contêiner do Amazon ECS
<a name="container-metadata"></a>

A partir da versão 1.15.0 do agente de contêiner do Amazon ECS, vários metadados de contêiner estão disponíveis em seus contêineres ou na instância de contêiner do host. Ao habilitar esse recurso, é possível consultar as informações sobre uma tarefa, um contêiner e uma instância de contêiner de dentro do contêiner ou da instância de contêiner do host. O arquivo de metadados é criado na instância do host e montado no contêiner como um volume do Docker e, portanto, não fica disponível quando uma tarefa é hospedada no AWS Fargate.

O arquivo de metadados do contêiner é limpo na instância do host quando o contêiner é limpo. É possível ajustar quando isso acontece com a variável do agente de contêiner `ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION`. Para obter mais informações, consulte [Limpeza automática de tarefas e de imagens do Amazon ECS](automated_image_cleanup.md).

**Topics**
+ [Locais do arquivo de metadados do contêiner](#metadata-file-locations)
+ [Ativação de metadados de contêiner do Amazon ECS](enable-metadata.md)
+ [Formato do arquivo de metadados de contêiner do Amazon ECS](metadata-file-format.md)

## Locais do arquivo de metadados do contêiner
<a name="metadata-file-locations"></a>

Por padrão, o arquivo de metadados do contêiner é gravado nos seguintes caminhos de host e contêiner.
+ **Para instâncias do Linux:**
  + Caminho do host: `/var/lib/ecs/data/metadata/cluster_name/task_id/container_name/ecs-container-metadata.json`
**nota**  
O caminho do host Linux pressupõe que o caminho padrão de montagem do diretório de dados (`/var/lib/ecs/data`) é usado quando o agente é iniciado. Se você não estiver usando a AMI otimizada para Amazon ECS (ou o pacote `ecs-init` para iniciar e manter o agente de contêiner), defina a variável de configuração do agente `ECS_HOST_DATA_DIR` para o caminho do host em que está localizado o arquivo de estado do agente de contêiner. Para obter mais informações, consulte [Configuração do agente de contêiner do Amazon ECS](ecs-agent-config.md).
  + Caminho do contêiner: `/opt/ecs/metadata/random_ID/ecs-container-metadata.json`
+ **Para instâncias Windows:**
  + Caminho do host: `C:\ProgramData\Amazon\ECS\data\metadata\task_id\container_name\ecs-container-metadata.json`
  + Caminho do contêiner: `C:\ProgramData\Amazon\ECS\metadata\random_ID\ecs-container-metadata.json`

No entanto, para acesso fácil, o local do arquivo de metadados do contêiner é definido na variável de ambiente `ECS_CONTAINER_METADATA_FILE`, dentro do contêiner. É possível ler o conteúdo do arquivo de dentro de contêiner com o comando a seguir:
+ **Para instâncias do Linux:**

  ```
  cat $ECS_CONTAINER_METADATA_FILE
  ```
+ **Para instâncias do Windows (PowerShell):**

  ```
  Get-Content -path $env:ECS_CONTAINER_METADATA_FILE
  ```