

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# File di metadati di container di Amazon ECS
<a name="container-metadata"></a>

A partire dalla versione 1.15.0 dell'agente di container di Amazon ECS, vari metadati di container sono disponibili all'interno dei contenitori o dell'istanza di container host. Attivando questa caratteristica, è possibile eseguire una query delle informazioni su un'attività, un container e un'istanza di container all'interno del container stesso o dell'istanza di container host. Il file di metadati viene creato sull'istanza host e montato nel contenitore come volume Docker e pertanto non è disponibile quando un'attività è ospitata su AWS Fargate.

Il file di metadati di container viene pulito sull'istanza host quando avviene lo stesso per il container. Puoi definire il momento in cui ciò accade tramite la variabile `ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION` dell'agente di container. Per ulteriori informazioni, consulta [Pulizia automatica dell'immagine e dell'attività Amazon ECS](automated_image_cleanup.md).

**Topics**
+ [Posizioni dei file di metadati dei container](#metadata-file-locations)
+ [Attivazione dei metadati dei container Amazon ECS](enable-metadata.md)
+ [Formato del file di metadati di container di Amazon ECS](metadata-file-format.md)

## Posizioni dei file di metadati dei container
<a name="metadata-file-locations"></a>

Di default, il file di metadati di container viene scritto sui percorsi di host e di container seguenti.
+ **Per le istanze Linux:**
  + Percorso host: `/var/lib/ecs/data/metadata/cluster_name/task_id/container_name/ecs-container-metadata.json`
**Nota**  
Il percorse dell'host di Linux presuppone che venga utilizzato il percorso di montaggio della directory dei dati predefinito (`/var/lib/ecs/data`) all'avvio dell'agente. Se non utilizzi l'AMI ottimizzata per Amazon ECS (o il pacchetto `ecs-init` per avviare e mantenere l'agente di container), assicurati di impostare la variabile di configurazione dell'agente `ECS_HOST_DATA_DIR` sul percorso dell'host in cui è ubicato il file di stato dell'agente del container. Per ulteriori informazioni, consulta [Configurazione dell'agente del container Amazon ECS](ecs-agent-config.md).
  + Percorso container: `/opt/ecs/metadata/random_ID/ecs-container-metadata.json`
+ **Per le istanze Windows:**
  + Percorso host: `C:\ProgramData\Amazon\ECS\data\metadata\task_id\container_name\ecs-container-metadata.json`
  + Percorso container: `C:\ProgramData\Amazon\ECS\metadata\random_ID\ecs-container-metadata.json`

Tuttavia, per semplificare l'accesso, l'ubicazione del file di metadati di container è impostata sulla variabile di ambiente `ECS_CONTAINER_METADATA_FILE` all'interno del container. Puoi leggere il file contenuti dall'interno del container attraverso il comando seguente:
+ **Per le istanze Linux:**

  ```
  cat $ECS_CONTAINER_METADATA_FILE
  ```
+ **Per le istanze Windows (): PowerShell**

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