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.
# Point de terminaison des métadonnées de tâches Amazon ECS version 3
**Important**
Le point de terminaison des métadonnées de tâches version 3 n'est plus activement maintenu. Nous vous recommandons de mettre à jour le point de terminaison des métadonnées de tâches version 4 afin d'obtenir les dernières informations relatives au point de terminaison des métadonnées. Pour de plus amples informations, veuillez consulter [Point de terminaison des métadonnées de tâches Amazon ECS version 4](task-metadata-endpoint-v4.md).
Si vous utilisez des tâches Amazon ECS hébergées sur AWS Fargate, consultez la [version 3 du point de terminaison des métadonnées des tâches Amazon ECS pour les tâches sur Fargate.](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v3-fargate.html)
À partir de la version 1.21.0 de l'agent de conteneur Amazon ECS, l'agent injecte une variable d'environnement appelée `ECS_CONTAINER_METADATA_URI` dans chaque conteneur d'une tâche. Lorsque vous interrogez le point de terminaison des métadonnées de tâches version 3, diverses métadonnées de tâches et [statistiques Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) sont disponibles pour les tâches. Pour les tâches qui utilisent le mode réseau `bridge`, les métriques réseau sont disponibles sont disponibles lors de l'interrogation des points de terminaison `/stats`.
La fonctionnalité de point de terminaison des métadonnées de tâches version 3 est activée par défaut pour les tâches qui utilisent Fargate sur la version de plateforme v1.3.0 ou ultérieure et les tâches qui utilisent EC2 et qui sont lancées sur l’infrastructure Linux Amazon EC2 exécutant au moins la version 1.21.0 de l’agent de conteneur Amazon ECS ou sur une infrastructure Windows Amazon EC2 exécutant au moins la version `1.54.0` de l’agent de conteneur Amazon ECS et qui utilisent le mode réseau `awsvpc`. Pour de plus amples informations, veuillez consulter [Gestion des instances de conteneur Amazon ECS Linux](manage-linux.md).
Vous pouvez ajouter la prise en charge de cette fonctionnalité sur des anciennes instances de conteneur en mettant à jour l'agent à l'aide de la dernière version. Pour de plus amples informations, veuillez consulter [Mise à jour de l'agent de conteneur Amazon ECS](ecs-agent-update.md).
**Important**
Pour les tâches qui utilisent Fargate et les versions de plateforme antérieures à v1.3.0, le point de terminaison des métadonnées de tâches version 2 est pris en charge. Pour de plus amples informations, veuillez consulter [Point de terminaison des métadonnées de tâches Amazon ECS version 2](task-metadata-endpoint-v2.md).
## Chemins des points de terminaison des métadonnées de tâches version 3
Les points de terminaison des métadonnées de tâches suivants sont disponibles pour les conteneurs :
`${ECS_CONTAINER_METADATA_URI}`
Ce chemin renvoie des métadonnées JSON pour le conteneur.
`${ECS_CONTAINER_METADATA_URI}/task`
Ce chemin renvoie des métadonnées JSON pour la tâche, y compris une liste des conteneurs IDs et les noms de tous les conteneurs associés à la tâche. Pour plus d'informations sur la réponse pour ce point de terminaison, consultez [Réponse JSON des métadonnées de tâches Amazon ECS v3](task-metadata-endpoint-v3-response.md).
`${ECS_CONTAINER_METADATA_URI}/taskWithTags`
Ce chemin renvoie les métadonnées de la tâche incluse dans le point de terminaison `/task` en plus des balises de tâche et d'instance de conteneur qui peuvent être récupérées à l'aide de l'API `ListTagsForResource`.
`${ECS_CONTAINER_METADATA_URI}/stats`
Ce chemin renvoie le JSON des statistiques Docker pour cet ID de conteneur Docker spécifique. Pour plus d'informations sur chacune des statistiques renvoyées, consultez la documentation [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)de l'API Docker.
`${ECS_CONTAINER_METADATA_URI}/task/stats`
Ce chemin renvoie le JSON des statistiques Docker pour tous les conteneurs associés à la tâche. Pour plus d'informations sur chacune des statistiques renvoyées, consultez la documentation [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)de l'API Docker.
# Réponse JSON des métadonnées de tâches Amazon ECS v3
Les informations suivantes sont renvoyées à partir de la réponse JSON du point de terminaison de métadonnées de la tâche (`${ECS_CONTAINER_METADATA_URI}/task`).
`Cluster`
Amazon Resource Name (ARN) ou nom abrégé du cluster Amazon ECS auquel la tâche appartient.
`TaskARN`
L’Amazon Resource Name (ARN) de la tâche à laquelle le conteneur appartient.
`Family`
Famille de la définition de tâche Amazon ECS pour la tâche.
`Revision`
Révision de la définition de tâche Amazon ECS pour la tâche.
`DesiredStatus`
État souhaité pour la tâche à partir d'Amazon ECS.
`KnownStatus`
État connu pour la tâche à partir d'Amazon ECS.
`Limits`
Les limites de ressources spécifiées au niveau de la tâche, telles que le processeur (exprimé en vCPUs) et la mémoire. Ce paramètre n'est pas spécifié si aucune limite de ressource n'a été définie.
`PullStartedAt`
Horodatage au moment où la première extraction de l'image de conteneur a commencé.
`PullStoppedAt`
Horodatage au moment où la dernière extraction de l'image de conteneur s'est terminée.
`AvailabilityZone`
Zone de disponibilité dans laquelle se trouve la tâche.
Les métadonnées de la zone de disponibilité sont uniquement disponibles pour les tâches Fargate qui utilisent la version 1.4 de la plateforme ou ultérieure (Linux) ou la version 1.0.0 de la plateforme ou ultérieure (Windows).
`Containers`
Liste de métadonnées de conteneur pour chaque conteneur associé à la tâche.
`DockerId`
ID Docker du conteneur.
`Name`
Nom du conteneur tel que spécifié dans la définition de tâche.
`DockerName`
Nom du conteneur fourni à Docker. L'agent de conteneur Amazon ECS génère un nom unique pour le conteneur afin d'éviter les conflits de noms lorsque plusieurs copies de la même définition de tâche sont exécutées sur une seule instance.
`Image`
Image à utiliser pour le conteneur.
`ImageID`
Le condensé SHA-256 du manifeste de l’image. Il s’agit du condensé qui peut être utilisé pour extraire l’image en utilisant le format `repository-url/image@sha256:digest`.
`Ports`
Tous les ports exposés pour le conteneur. Ce paramètre n'est pas spécifié s'il n'y a pas de ports exposés.
`Labels`
Toutes les étiquettes appliquées au conteneur. Ce paramètre n'est pas spécifié si aucune étiquette n'est appliquée.
`DesiredStatus`
État souhaité pour le conteneur à partir d'Amazon ECS.
`KnownStatus`
État connu pour le conteneur à partir d'Amazon ECS.
`ExitCode`
Code de sortie pour le conteneur. Ce paramètre n'est pas spécifié si le conteneur n'est pas sorti.
`Limits`
Limites de ressource spécifiées au niveau du conteneur, par exemple, le processeur (exprimé en unités de processeur) et la mémoire. Ce paramètre n'est pas spécifié si aucune limite de ressource n'a été définie.
`CreatedAt`
Horodatage de création du conteneur. Ce paramètre n'est pas spécifié si le conteneur n'a pas encore été créé.
`StartedAt`
Horodatage de démarrage du conteneur. Ce paramètre n'est pas spécifié si le conteneur n'a pas encore été démarré.
`FinishedAt`
Horodatage d'arrêt du conteneur. Ce paramètre n'est pas spécifié si le conteneur n'a pas encore été arrêté.
`Type`
Type du conteneur. Les conteneurs qui sont spécifiés dans votre définition de tâche sont de type `NORMAL`. Vous pouvez ignorer les autres types de conteneurs, qui sont utilisés pour l'approvisionnement des ressources de tâches internes par l'agent de conteneur Amazon ECS.
`Networks`
Informations de réseau du conteneur, par exemple le mode réseau et l'adresse IP. Ce paramètre n'est pas spécifié si aucune information de réseau n'est définie.
`ClockDrift`
Informations sur la différence entre l'heure de référence et l'heure du système. Cela s'applique au système d'exploitation Linux. Cette fonctionnalité utilise le Service de synchronisation temporelle d’Amazon pour mesurer la précision de l’horloge et fournir l’erreur d’horloge liée aux conteneurs. Pour plus d’informations, consultez la section [Réglage de l’heure pour votre instance Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html) dans le *Guide de l’utilisateur Amazon EC2 pour les instances Linux*.
`ReferenceTime`
La base de la précision de l'horloge. Amazon ECS utilise la norme mondiale du temps universel coordonné (UTC) via NTP, par exemple `2021-09-07T16:57:44Z`.
`ClockErrorBound`
La mesure de l'erreur de l'horloge est exprimée par le décalage par rapport à l'UTC. Cette erreur correspond à la différence en millisecondes entre l'heure de référence et l'heure du système.
`ClockSynchronizationStatus`
Indique si la tentative de synchronisation la plus récente entre l'heure système et l'heure de référence a réussi.
Les valeurs valides sont `SYNCHRONIZED` et ` NOT_SYNCHRONIZED`.
`ExecutionStoppedAt`
Horodatage au moment où l'état des tâches est passé de `DesiredStatus` à `STOPPED`. Cela se produit lorsqu'un conteneur essentiel passe à `STOPPED`.
# Exemples de métadonnées de tâches Amazon ECS v3
Les exemples suivants présentent des sorties de points de terminaison des métadonnées de tâche.
## Exemple de réponse aux métadonnées du conteneur
Lors de l'interrogation du point de terminaison `${ECS_CONTAINER_METADATA_URI}`, seules les métadonnées sur le conteneur lui-même vous sont renvoyées. Voici un exemple de sortie.
```
{
"DockerId": "43481a6ce4842eec8fe72fc28500c6b52edcc0917f105b83379f88cac1ff3946",
"Name": "nginx-curl",
"DockerName": "ecs-nginx-5-nginx-curl-ccccb9f49db0dfe0d901",
"Image": "nrdlngr/nginx-curl",
"ImageID": "sha256:2e00ae64383cfc865ba0a2ba37f61b50a120d2d9378559dcd458dc0de47bc165",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "nginx-curl",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"com.amazonaws.ecs.task-definition-family": "nginx",
"com.amazonaws.ecs.task-definition-version": "5"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": {
"CPU": 512,
"Memory": 512
},
"CreatedAt": "2018-02-01T20:55:10.554941919Z",
"StartedAt": "2018-02-01T20:55:11.064236631Z",
"Type": "NORMAL",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.106"
]
}
]
}
```
## Exemple de réponse de métadonnées de tâches
Lors de l'interrogation du point de terminaison `${ECS_CONTAINER_METADATA_URI}/task`, les métadonnées relatives à la tâche dont le conteneur fait partie vous sont renvoyées. Voici un exemple de sortie.
La réponse JSON suivante est pour une tâche comportant un seul conteneur.
```
{
"Cluster": "default",
"TaskARN": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"Family": "nginx",
"Revision": "5",
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Containers": [
{
"DockerId": "731a0d6a3b4210e2448339bc7015aaa79bfe4fa256384f4102db86ef94cbbc4c",
"Name": "~internal~ecs~pause",
"DockerName": "ecs-nginx-5-internalecspause-acc699c0cbf2d6d11700",
"Image": "amazon/amazon-ecs-pause:0.1.0",
"ImageID": "",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "~internal~ecs~pause",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"com.amazonaws.ecs.task-definition-family": "nginx",
"com.amazonaws.ecs.task-definition-version": "5"
},
"DesiredStatus": "RESOURCES_PROVISIONED",
"KnownStatus": "RESOURCES_PROVISIONED",
"Limits": {
"CPU": 0,
"Memory": 0
},
"CreatedAt": "2018-02-01T20:55:08.366329616Z",
"StartedAt": "2018-02-01T20:55:09.058354915Z",
"Type": "CNI_PAUSE",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.106"
]
}
]
},
{
"DockerId": "43481a6ce4842eec8fe72fc28500c6b52edcc0917f105b83379f88cac1ff3946",
"Name": "nginx-curl",
"DockerName": "ecs-nginx-5-nginx-curl-ccccb9f49db0dfe0d901",
"Image": "nrdlngr/nginx-curl",
"ImageID": "sha256:2e00ae64383cfc865ba0a2ba37f61b50a120d2d9378559dcd458dc0de47bc165",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "nginx-curl",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"com.amazonaws.ecs.task-definition-family": "nginx",
"com.amazonaws.ecs.task-definition-version": "5"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": {
"CPU": 512,
"Memory": 512
},
"CreatedAt": "2018-02-01T20:55:10.554941919Z",
"StartedAt": "2018-02-01T20:55:11.064236631Z",
"Type": "NORMAL",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.106"
]
}
]
}
],
"PullStartedAt": "2018-02-01T20:55:09.372495529Z",
"PullStoppedAt": "2018-02-01T20:55:10.552018345Z",
"AvailabilityZone": "us-east-2b"
}
```