Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Fichier de métadonnées de conteneur Amazon ECS
<a name="container-metadata"></a>

À compter de la version 1.15.0 de l'agent conteneur Amazon ECS, diverses métadonnées de conteneur sont disponibles dans les conteneurs ou dans l'instance de conteneur hôte. En activant cette fonctionnalité, vous pouvez demander des informations sur une tâche, un conteneur ou une instance de conteneur depuis le conteneur ou l'instance de conteneur hôte. Le fichier de métadonnées est créé sur l'instance hôte et monté dans le conteneur en tant que volume Docker. Il n'est donc pas disponible lorsqu'une tâche est hébergée sur AWS Fargate.

Le fichier de métadonnées de conteneur est nettoyé sur l'instance de l'hôte lors du nettoyage du conteneur. Vous pouvez définir quand cette opération doit se produire avec la variable `ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION` de l'agent de conteneur. Pour de plus amples informations, veuillez consulter [Nettoyage automatique des tâches et des images Amazon ECS](automated_image_cleanup.md).

**Topics**
+ [Emplacements des fichiers de métadonnées de conteneur](#metadata-file-locations)
+ [Activation des métadonnées de conteneur Amazon ECS](enable-metadata.md)
+ [Format du fichier de métadonnées de conteneur Amazon ECS](metadata-file-format.md)

## Emplacements des fichiers de métadonnées de conteneur
<a name="metadata-file-locations"></a>

Par défaut, le fichier de métadonnées de conteneur est écrit sur les chemins d'hôte et de conteneur suivants.
+ **Pour les instances Linux :**
  + Chemin hôte :`/var/lib/ecs/data/metadata/cluster_name/task_id/container_name/ecs-container-metadata.json`
**Note**  
Le chemin hôte Linux suppose que le chemin de montage du répertoire de données par défaut (`/var/lib/ecs/data`) est utilisé lorsque l'agent est démarré. Si vous n'utilisez pas l'AMI optimisée pour Amazon ECS (ou le package `ecs-init` pour démarrer et gérer l'agent de conteneur), veillez à définir la variable de configuration de l'agent `ECS_HOST_DATA_DIR` sur le chemin hôte où se trouve le fichier d'état de l'agent de conteneur. Pour de plus amples informations, veuillez consulter [Configuration de l'agent de conteneur Amazon ECS](ecs-agent-config.md).
  + Chemin du conteneur : `/opt/ecs/metadata/random_ID/ecs-container-metadata.json`
+ **Pour les instances Windows :**
  + Chemin hôte :`C:\ProgramData\Amazon\ECS\data\metadata\task_id\container_name\ecs-container-metadata.json`
  + Chemin du conteneur : `C:\ProgramData\Amazon\ECS\metadata\random_ID\ecs-container-metadata.json`

Toutefois, pour en faciliter l'accès, l'emplacement du fichier de métadonnées de conteneur correspond à la variable d'environnement `ECS_CONTAINER_METADATA_FILE` à l'intérieur du conteneur. Vous pouvez lire le contenu du fichier depuis le conteneur via la commande suivante :
+ **Pour les instances Linux :**

  ```
  cat $ECS_CONTAINER_METADATA_FILE
  ```
+ **Pour les instances Windows (PowerShell) :**

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