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. # Métadonnées de tâches disponibles pour les tâches sur EC2 L'agent de conteneur Amazon ECS fournit une méthode pour récupérer les diverses métadonnées de tâches et les [statistiques Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats). On parle alors du point de terminaison des métadonnées de tâches. Les versions suivantes sont disponibles : + Point de terminaison des métadonnées de tâche version 4 : fournit une variété de métadonnées et de statistiques Docker aux conteneurs. Peut également fournir des données de débit réseau. Disponible pour les tâches Amazon ECS lancées sur des instances Linux Amazon EC2 exécutant au moins la version `1.39.0` de l'agent de conteneur Amazon ECS. Pour les instances Windows Amazon EC2 qui utilisent le mode réseau `awsvpc`, la version de l'agent de conteneur Amazon ECS doit être au moins `1.54.0`. 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). + Point de terminaison des métadonnées de tâche version 3 : fournit une variété de métadonnées et de statistiques Docker aux conteneurs. Disponible pour les tâches Amazon ECS lancées sur des instances Linux Amazon EC2 exécutant au moins la version `1.21.0` de l'agent de conteneur Amazon ECS. Pour les instances Windows Amazon EC2 qui utilisent le mode réseau `awsvpc`, la version de l'agent de conteneur Amazon ECS doit être au moins `1.54.0`. Pour de plus amples informations, veuillez consulter [Point de terminaison des métadonnées de tâches Amazon ECS version 3](task-metadata-endpoint-v3.md). + Point de terminaison de métadonnées de tâche version 2 : disponible pour les tâches Amazon ECS lancées sur des instances Linux Amazon EC2 exécutant au moins la version `1.17.0` de l'agent de conteneur Amazon ECS. Pour les instances Windows Amazon EC2 qui utilisent le mode réseau `awsvpc`, la version de l'agent de conteneur Amazon ECS doit être au moins `1.54.0`. 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). Si votre tâche Amazon ECS est hébergée sur Amazon EC2, ou si votre tâche utilise le mode `host` réseau et est hébergée sur des instances gérées Amazon ECS, vous pouvez également accéder aux métadonnées de l'hôte de la tâche via le point de terminaison [IMDS (Instance Metadata Service)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html). La commande suivante, lorsqu'elle est exécutée depuis l'instance hébergeant la tâche, répertorie l'ID de l'instance hôte. ``` curl http://169.254.169.254/latest/meta-data/instance-id ``` Si votre tâche Amazon ECS est hébergée sur Amazon EC2 et dans une configuration réservée IPv6 uniquement, vous pouvez accéder aux métadonnées de l'hôte de la tâche via le IPv6 point de terminaison IMDS. La commande suivante, lorsqu'elle est exécutée depuis l'instance hébergeant la tâche, répertorie l'ID de l'instance hôte IPv6. ``` curl http://[fd00:ec2::254]/latest/meta-data/instance-id ``` Pour accéder au point de terminaison IPv6 IMDS, activez le point de terminaison IPv6 IMDS sur votre instance de conteneur et configurez également le mode de point de terminaison du service de métadonnées à l'aide du fournisseur d'informations d'identification IMDS pour le SDK que vous avez choisi. `IPv6` Pour plus d'informations sur l'activation du point de terminaison IPv6 IMDS pour votre instance de conteneur, consultez [Configurer les options du service de métadonnées d'instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html) dans le guide de l'*utilisateur Amazon EC2*. Pour plus d'informations sur le fournisseur d'informations d'identification IMDS pour SDKs, voir fournisseur [d'informations d'identification IMDS dans le guide](https://docs.aws.amazon.com/sdkref/latest/guide/feature-imds-credentials.html) de référence *AWS SDKs et* Tools. **Note** Le point de terminaison IPv6 IMDS n'est pas accessible lorsque le paramètre du `awsvpcTrunking` compte est activé. Pour accéder aux informations d’identification du rôle IAM de l’instance de conteneur lorsque `awsvpcTrunking` est activée, vous pouvez utiliser un rôle IAM de tâche à la place. Pour plus d’informations sur les rôles IAM, consultez la section [rôle IAM de tâche Amazon ECS](task-iam-roles.md). Les informations que vous pouvez obtenir à partir du point de terminaison sont divisées en catégories telles que `instance-id`. Pour plus d’informations sur les différentes catégories de métadonnées d’instance hôte que vous pouvez obtenir à l’aide du point de terminaison, consultez la section [Catégories de métadonnées d’instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html#instancedata-data-categories). # Point de terminaison des métadonnées de tâches Amazon ECS version 4 L'agent de conteneur Amazon ECS injecte une variable d'environnement dans chaque conteneur, appelée *point de terminaison des métadonnées de tâches*, qui fournit diverses métadonnées de tâches et [statistiques Docker](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats) au conteneur. Les métadonnées des tâches et les statistiques du débit du réseau sont envoyées à CloudWatch Container Insights et peuvent être consultées dans le AWS Management Console. Pour de plus amples informations, veuillez consulter [Surveillance des conteneurs Amazon ECS au moyen de Container Insights avec observabilité améliorée](cloudwatch-container-insights.md). **Note** Amazon ECS fournit des versions antérieures du point de terminaison des métadonnées de tâches. Pour éviter de créer d'autres versions de point de terminaison de métadonnées de tâche à l'avenir, des métadonnées supplémentaires peuvent être ajoutées à la sortie de la version 4. Nous ne supprimons pas les métadonnées existantes et ne modifions pas les noms des champs de métadonnées. La variable d'environnement est injectée par défaut dans les conteneurs des tâches Amazon ECS lancées sur les instances Linux Amazon EC2 exécutant au moins la version `1.39.0` de l'agent de conteneur Amazon ECS. Pour les instances Windows Amazon EC2 qui utilisent le mode réseau `awsvpc`, la version de l'agent de conteneur Amazon ECS doit être au moins `1.54.0`. Pour de plus amples informations, veuillez consulter [Gestion des instances de conteneur Amazon ECS Linux](manage-linux.md). **Note** Vous pouvez ajouter la prise en charge de cette fonctionnalité sur les instances Amazon EC2 utilisant des versions plus anciennes de l'agent de conteneur Amazon ECS en mettant à jour l'agent à la dernière version. Pour de plus amples informations, veuillez consulter [Mise à jour de l'agent de conteneur Amazon ECS](ecs-agent-update.md). Pour des exemples de sortie de métadonnées de tâches, consultez la section [Exemples de métadonnées de tâches Amazon ECS v4](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v4-examples.html). ## Chemins des points de terminaison des métadonnées de tâches version 4 Les chemins des points de terminaison des métadonnées de tâches suivants sont disponibles pour les conteneurs : `${ECS_CONTAINER_METADATA_URI_V4}` Ce chemin renvoie des métadonnées pour le conteneur. `${ECS_CONTAINER_METADATA_URI_V4}/task` Ce chemin renvoie les métadonnées de 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 v4](task-metadata-endpoint-v4-response.md). `${ECS_CONTAINER_METADATA_URI_V4}/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`. Toutes les erreurs reçues lors de la récupération des métadonnées de balise seront incluses dans le champ `Errors` de la réponse. Le champ `Errors` est uniquement dans la réponse pour les tâches hébergées sur des instances Linux Amazon EC2 exécutant au moins la version `1.50.0` de l'agent de conteneur. Pour les instances Windows Amazon EC2 qui utilisent le mode réseau `awsvpc`, la version de l'agent de conteneur Amazon ECS doit être au moins `1.54.0`. Ce point de terminaison nécessite l'autorisation `ecs.ListTagsForResource`. Lorsque vous utilisez le point de terminaison `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags`, sachez que chaque appel génère jusqu’à deux requêtes d’API `ecs:ListTagsForResource` (une pour les balises d’instance de conteneur et une pour les balises de tâche) et que tous les conteneurs sidecar de la tâche peuvent effectuer ces appels en votre nom. Les appels fréquents aux points de terminaison peuvent entraîner une limitation de l’API. Envisagez de mettre en œuvre des stratégies de mise en cache ou de traitement par lots pour réduire la fréquence des appels, en particulier dans les applications à fort trafic, et de résoudre les problèmes de limitation des API en utilisant AWS CloudTrail. Pour plus d’informations sur les seuils de limitation de l’API `ListTagsForResource`, consultez la section [Limitation des demandes pour l’API Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/request-throttling.html) dans la *Référence API Amazon Elastic Container Service*. Pour plus d'informations sur le débogage des appels d'API Amazon ECS à l'aide AWS CloudTrail de. [Enregistrez les appels d'API Amazon ECS à l'aide de AWS CloudTrail](logging-using-cloudtrail.md) `${ECS_CONTAINER_METADATA_URI_V4}/stats` Ce chemin renvoie les statistiques Docker pour ce conteneur spécifique. Pour plus d'informations sur chacune des statistiques renvoyées, consultez la documentation [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)de l'API Docker. Pour les tâches Amazon ECS qui utilisent les modes réseau `awsvpc` ou `bridge` hébergés sur des instances Linux Amazon EC2 exécutant au moins la version `1.43.0` de l'agent de conteneur, il y aura des statistiques de débit réseau supplémentaires incluses dans la réponse. Pour toutes les autres tâches, la réponse inclura uniquement les statistiques cumulatives du réseau. `${ECS_CONTAINER_METADATA_URI_V4}/task/stats` Ce chemin renvoie les statistiques Docker pour tous les conteneurs associés à la tâche. Il peut être utilisé par les conteneurs sidecar pour extraire les métriques réseau. Pour plus d'informations sur chacune des statistiques renvoyées, consultez la documentation [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)de l'API Docker. Pour les tâches Amazon ECS qui utilisent les modes réseau `awsvpc` ou `bridge` hébergés sur des instances Linux Amazon EC2 exécutant au moins la version `1.43.0` de l'agent de conteneur, il y aura des statistiques de débit réseau supplémentaires incluses dans la réponse. Pour toutes les autres tâches, la réponse inclura uniquement les statistiques cumulatives du réseau. # Réponse JSON des métadonnées de tâches Amazon ECS v4 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_V4}/task`). Cela inclut les métadonnées associées à la tâche en plus des métadonnées de chaque conteneur dans la tâche. `Cluster` Amazon Resource Name (ARN) ou nom abrégé du cluster Amazon ECS auquel la tâche appartient. `ServiceName` Nom du service auquel appartient la tâche. ServiceName apparaîtra pour les instances de conteneur Amazon EC2 et Amazon ECS Anywhere si la tâche est associée à un service. Les métadonnées `ServiceName` sont incluses uniquement lors de l'utilisation de la version de l'agent de conteneur Amazon ECS `1.63.1` ou version ultérieure. `VPCID` L'identifiant VPC de l'instance de conteneur Amazon EC2. Ce champ apparaît uniquement pour les instances Amazon EC2. Les métadonnées `VPCID` sont incluses uniquement lors de l'utilisation de la version de l'agent de conteneur Amazon ECS `1.63.1` ou version ultérieure. `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 (Windows). `LaunchType` Type de lancement utilisé par la tâche. Lorsque vous utilisez des fournisseurs de capacité de cluster, cela indique si la tâche utilise l'infrastructure Fargate ou EC2. Ces métadonnées `LaunchType` sont incluses uniquement lors de l'utilisation de la version de l'agent de conteneur Amazon ECS Linux `1.45.0` ou version ultérieure (Linux) ou 1.0.0 ou ultérieure (Windows). `Containers` Liste de métadonnées de conteneur pour chaque conteneur associé à la tâche. `DockerId` ID Docker du conteneur. Lorsque vous utilisez Fargate, l'ID est un hexadécimal de 32 chiffres suivi d'un nombre de 10 chiffres. `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. `LogDriver` Pilote de journal utilisé par le conteneur. Ces métadonnées `LogDriver` sont incluses uniquement lors de l'utilisation de la version de l'agent de conteneur Amazon ECS Linux `1.45.0` ou version ultérieure. `LogOptions` Options de pilote de journal définies pour le conteneur. Ces métadonnées `LogOptions` sont incluses uniquement lors de l'utilisation de la version de l'agent de conteneur Amazon ECS Linux `1.45.0` ou version ultérieure. `ContainerARN` L'Amazon Resource Name (ARN) du conteneur. Ces métadonnées `ContainerARN` sont incluses uniquement lors de l'utilisation de la version de l'agent de conteneur Amazon ECS Linux `1.45.0` ou version ultérieure. `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. `RestartCount` Nombre de fois où le conteneur a été redémarré. Les métadonnées `RestartCount` ne sont incluses que si une politique de redémarrage est activée pour le conteneur. Pour de plus amples informations, veuillez consulter [Redémarrage de conteneurs individuels dans les tâches Amazon ECS à l’aide de politiques de redémarrage de conteneurs](container-restart-policy.md). `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 v4 Les exemples suivants présentent des sorties de chaque point de terminaison des métadonnées de tâche. ## Exemple de réponse de métadonnées du conteneur Lors de l'interrogation du point de terminaison `${ECS_CONTAINER_METADATA_URI_V4}`, seules les métadonnées sur le conteneur lui-même vous sont renvoyées. Voici un exemple de résultat d'une tâche exécutée dans le cadre d'un service (MyService). ``` { "DockerId": "ea32192c8553fbff06c9340478a2ff089b2bb5646fb718b4ee206641c9086d66", "Name": "curl", "DockerName": "ecs-curltest-24-curl-cca48e8dcadd97805600", "Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest", "ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/8f03e41243824aea923aca126495f665", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "24" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 10, "Memory": 128 }, "CreatedAt": "2020-10-02T00:15:07.620912337Z", "StartedAt": "2020-10-02T00:15:08.062559351Z", "Type": "NORMAL", "LogDriver": "awslogs", "LogOptions": { "awslogs-create-group": "true", "awslogs-group": "/ecs/metadata", "awslogs-region": "us-west-2", "awslogs-stream": "ecs/curl/8f03e41243824aea923aca126495f665" }, "ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/0206b271-b33f-47ab-86c6-a0ba208a70a9", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.100" ], "AttachmentIndex": 0, "MACAddress": "0e:9e:32:c7:48:85", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-100.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] } ``` ## Exemple de réponse de métadonnées de tâches Lors de l'interrogation du point de terminaison `${ECS_CONTAINER_METADATA_URI_V4}/task`, les métadonnées relatives à la tâche dont le conteneur fait partie en plus des métadonnées pour chaque conteneur dans la tâche vous sont renvoyées. Voici un exemple de sortie. ``` { "Cluster": "default", "TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "Family": "curltest", "ServiceName": "MyService", "Revision": "26", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "PullStartedAt": "2020-10-02T00:43:06.202617438Z", "PullStoppedAt": "2020-10-02T00:43:06.31288465Z", "AvailabilityZone": "us-west-2d", "VPCID": "vpc-1234567890abcdef0", "LaunchType": "EC2", "Containers": [ { "DockerId": "598cba581fe3f939459eaba1e071d5c93bb2c49b7d1ba7db6bb19deeb70d8e38", "Name": "~internal~ecs~pause", "DockerName": "ecs-curltest-26-internalecspause-e292d586b6f9dade4a00", "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-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RESOURCES_PROVISIONED", "KnownStatus": "RESOURCES_PROVISIONED", "Limits": { "CPU": 0, "Memory": 0 }, "CreatedAt": "2020-10-02T00:43:05.602352471Z", "StartedAt": "2020-10-02T00:43:06.076707576Z", "Type": "CNI_PAUSE", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] }, { "DockerId": "ee08638adaaf009d78c248913f629e38299471d45fe7dc944d1039077e3424ca", "Name": "curl", "DockerName": "ecs-curltest-26-curl-a0e7dba5aca6d8cb2e00", "Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest", "ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 10, "Memory": 128 }, "CreatedAt": "2020-10-02T00:43:06.326590752Z", "StartedAt": "2020-10-02T00:43:06.767535449Z", "Type": "NORMAL", "LogDriver": "awslogs", "LogOptions": { "awslogs-create-group": "true", "awslogs-group": "/ecs/metadata", "awslogs-region": "us-west-2", "awslogs-stream": "ecs/curl/158d1c8083dd49d6b527399fd6414f5c" }, "ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/abb51bdd-11b4-467f-8f6c-adcfe1fe059d", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] } ] } ``` ## Exemple de tâche avec réponse de métadonnées de balises Lors de l'interrogation du point de terminaison `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags`, les métadonnées relatives à la tâche, y compris les balises de tâche et d'instance de conteneur vous sont renvoyées. Voici un exemple de sortie. ``` { "Cluster": "default", "TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "Family": "curltest", "ServiceName": "MyService", "Revision": "26", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "PullStartedAt": "2020-10-02T00:43:06.202617438Z", "PullStoppedAt": "2020-10-02T00:43:06.31288465Z", "AvailabilityZone": "us-west-2d", "VPCID": "vpc-1234567890abcdef0", "TaskTags": { "tag-use": "task-metadata-endpoint-test" }, "ContainerInstanceTags":{ "tag_key":"tag_value" }, "LaunchType": "EC2", "Containers": [ { "DockerId": "598cba581fe3f939459eaba1e071d5c93bb2c49b7d1ba7db6bb19deeb70d8e38", "Name": "~internal~ecs~pause", "DockerName": "ecs-curltest-26-internalecspause-e292d586b6f9dade4a00", "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-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RESOURCES_PROVISIONED", "KnownStatus": "RESOURCES_PROVISIONED", "Limits": { "CPU": 0, "Memory": 0 }, "CreatedAt": "2020-10-02T00:43:05.602352471Z", "StartedAt": "2020-10-02T00:43:06.076707576Z", "Type": "CNI_PAUSE", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] }, { "DockerId": "ee08638adaaf009d78c248913f629e38299471d45fe7dc944d1039077e3424ca", "Name": "curl", "DockerName": "ecs-curltest-26-curl-a0e7dba5aca6d8cb2e00", "Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest", "ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 10, "Memory": 128 }, "CreatedAt": "2020-10-02T00:43:06.326590752Z", "StartedAt": "2020-10-02T00:43:06.767535449Z", "Type": "NORMAL", "LogDriver": "awslogs", "LogOptions": { "awslogs-create-group": "true", "awslogs-group": "/ecs/metadata", "awslogs-region": "us-west-2", "awslogs-stream": "ecs/curl/158d1c8083dd49d6b527399fd6414f5c" }, "ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/abb51bdd-11b4-467f-8f6c-adcfe1fe059d", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] } ] } ``` ## Exemple de tâche avec balises contenant une réponse de métadonnées d'erreur Lors de l'interrogation du point de terminaison `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags`, les métadonnées relatives à la tâche, y compris les balises de tâche et d'instance de conteneur vous sont renvoyées. S'il y a une erreur lors de la récupération des données d'étiquette, l'erreur est renvoyée dans la réponse. Ce qui suit est un exemple de sortie lorsque le rôle IAM associé à l'instance de conteneur n'a pas l'autorisation `ecs:ListTagsForResource`. ``` { "Cluster": "default", "TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "Family": "curltest", "ServiceName": "MyService", "Revision": "26", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "PullStartedAt": "2020-10-02T00:43:06.202617438Z", "PullStoppedAt": "2020-10-02T00:43:06.31288465Z", "AvailabilityZone": "us-west-2d", "VPCID": "vpc-1234567890abcdef0", "Errors": [ { "ErrorField": "ContainerInstanceTags", "ErrorCode": "AccessDeniedException", "ErrorMessage": "User: arn:aws:sts::111122223333:assumed-role/ecsInstanceRole/i-0744a608689EXAMPLE is not authorized to perform: ecs:ListTagsForResource on resource: arn:aws:ecs:us-west-2:111122223333:container-instance/default/2dd1b186f39845a584488d2ef155c131", "StatusCode": 400, "RequestId": "cd597ef0-272b-4643-9bd2-1de469870fa6", "ResourceARN": "arn:aws:ecs:us-west-2:111122223333:container-instance/default/2dd1b186f39845a584488d2ef155c131" }, { "ErrorField": "TaskTags", "ErrorCode": "AccessDeniedException", "ErrorMessage": "User: arn:aws:sts::111122223333:assumed-role/ecsInstanceRole/i-0744a608689EXAMPLE is not authorized to perform: ecs:ListTagsForResource on resource: arn:aws:ecs:us-west-2:111122223333:task/default/9ef30e4b7aa44d0db562749cff4983f3", "StatusCode": 400, "RequestId": "862c5986-6cd2-4aa6-87cc-70be395531e1", "ResourceARN": "arn:aws:ecs:us-west-2:111122223333:task/default/9ef30e4b7aa44d0db562749cff4983f3" } ], "LaunchType": "EC2", "Containers": [ { "DockerId": "598cba581fe3f939459eaba1e071d5c93bb2c49b7d1ba7db6bb19deeb70d8e38", "Name": "~internal~ecs~pause", "DockerName": "ecs-curltest-26-internalecspause-e292d586b6f9dade4a00", "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-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RESOURCES_PROVISIONED", "KnownStatus": "RESOURCES_PROVISIONED", "Limits": { "CPU": 0, "Memory": 0 }, "CreatedAt": "2020-10-02T00:43:05.602352471Z", "StartedAt": "2020-10-02T00:43:06.076707576Z", "Type": "CNI_PAUSE", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] }, { "DockerId": "ee08638adaaf009d78c248913f629e38299471d45fe7dc944d1039077e3424ca", "Name": "curl", "DockerName": "ecs-curltest-26-curl-a0e7dba5aca6d8cb2e00", "Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest", "ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 10, "Memory": 128 }, "CreatedAt": "2020-10-02T00:43:06.326590752Z", "StartedAt": "2020-10-02T00:43:06.767535449Z", "Type": "NORMAL", "LogDriver": "awslogs", "LogOptions": { "awslogs-create-group": "true", "awslogs-group": "/ecs/metadata", "awslogs-region": "us-west-2", "awslogs-stream": "ecs/curl/158d1c8083dd49d6b527399fd6414f5c" }, "ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/abb51bdd-11b4-467f-8f6c-adcfe1fe059d", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] } ] } ``` ## Exemple de réponse des statistiques de conteneur Lors de l'interrogation du point de terminaison `${ECS_CONTAINER_METADATA_URI_V4}/stats`, les métriques réseau pour conteneur sont renvoyées. Pour les tâches Amazon ECS qui utilisent les modes réseau `awsvpc` ou `bridge` hébergés sur des instances Amazon EC2 exécutant au moins la version `1.43.0` de l'agent de conteneur, il y aura des statistiques de débit réseau supplémentaires incluses dans la réponse. Pour toutes les autres tâches, la réponse inclura uniquement les statistiques cumulatives du réseau. Voici un exemple de sortie d'une tâche Amazon ECS sur Amazon EC2 qui utilise le mode réseau `bridge`. ``` { "read": "2020-10-02T00:51:13.410254284Z", "preread": "2020-10-02T00:51:12.406202398Z", "pids_stats": { "current": 3 }, "blkio_stats": { "io_service_bytes_recursive": [ ], "io_serviced_recursive": [ ], "io_queue_recursive": [ ], "io_service_time_recursive": [ ], "io_wait_time_recursive": [ ], "io_merged_recursive": [ ], "io_time_recursive": [ ], "sectors_recursive": [ ] }, "num_procs": 0, "storage_stats": { }, "cpu_stats": { "cpu_usage": { "total_usage": 360968065, "percpu_usage": [ 182359190, 178608875 ], "usage_in_kernelmode": 40000000, "usage_in_usermode": 290000000 }, "system_cpu_usage": 13939680000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "precpu_stats": { "cpu_usage": { "total_usage": 360968065, "percpu_usage": [ 182359190, 178608875 ], "usage_in_kernelmode": 40000000, "usage_in_usermode": 290000000 }, "system_cpu_usage": 13937670000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "memory_stats": { "usage": 1806336, "max_usage": 6299648, "stats": { "active_anon": 606208, "active_file": 0, "cache": 0, "dirty": 0, "hierarchical_memory_limit": 134217728, "hierarchical_memsw_limit": 268435456, "inactive_anon": 0, "inactive_file": 0, "mapped_file": 0, "pgfault": 4185, "pgmajfault": 0, "pgpgin": 2926, "pgpgout": 2778, "rss": 606208, "rss_huge": 0, "total_active_anon": 606208, "total_active_file": 0, "total_cache": 0, "total_dirty": 0, "total_inactive_anon": 0, "total_inactive_file": 0, "total_mapped_file": 0, "total_pgfault": 4185, "total_pgmajfault": 0, "total_pgpgin": 2926, "total_pgpgout": 2778, "total_rss": 606208, "total_rss_huge": 0, "total_unevictable": 0, "total_writeback": 0, "unevictable": 0, "writeback": 0 }, "limit": 134217728 }, "name": "/ecs-curltest-26-curl-c2e5f6e0cf91b0bead01", "id": "5fc21e5b015f899d22618f8aede80b6d70d71b2a75465ea49d9462c8f3d2d3af", "networks": { "eth0": { "rx_bytes": 84, "rx_packets": 2, "rx_errors": 0, "rx_dropped": 0, "tx_bytes": 84, "tx_packets": 2, "tx_errors": 0, "tx_dropped": 0 } }, "network_rate_stats": { "rx_bytes_per_sec": 0, "tx_bytes_per_sec": 0 } } ``` ## Exemple de réponse des statistiques de tâche Lors de l'interrogation du point de terminaison `${ECS_CONTAINER_METADATA_URI_V4}/task/stats`, les métriques réseau dont le conteneur fait partie vous sont renvoyées. Voici un exemple de sortie. ``` { "01999f2e5c6cf4df3873f28950e6278813408f281c54778efec860d0caad4854": { "read": "2020-10-02T00:51:32.51467703Z", "preread": "2020-10-02T00:51:31.50860463Z", "pids_stats": { "current": 1 }, "blkio_stats": { "io_service_bytes_recursive": [ ], "io_serviced_recursive": [ ], "io_queue_recursive": [ ], "io_service_time_recursive": [ ], "io_wait_time_recursive": [ ], "io_merged_recursive": [ ], "io_time_recursive": [ ], "sectors_recursive": [ ] }, "num_procs": 0, "storage_stats": { }, "cpu_stats": { "cpu_usage": { "total_usage": 177232665, "percpu_usage": [ 13376224, 163856441 ], "usage_in_kernelmode": 0, "usage_in_usermode": 160000000 }, "system_cpu_usage": 13977820000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "precpu_stats": { "cpu_usage": { "total_usage": 177232665, "percpu_usage": [ 13376224, 163856441 ], "usage_in_kernelmode": 0, "usage_in_usermode": 160000000 }, "system_cpu_usage": 13975800000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "memory_stats": { "usage": 532480, "max_usage": 6279168, "stats": { "active_anon": 40960, "active_file": 0, "cache": 0, "dirty": 0, "hierarchical_memory_limit": 9223372036854771712, "hierarchical_memsw_limit": 9223372036854771712, "inactive_anon": 0, "inactive_file": 0, "mapped_file": 0, "pgfault": 2033, "pgmajfault": 0, "pgpgin": 1734, "pgpgout": 1724, "rss": 40960, "rss_huge": 0, "total_active_anon": 40960, "total_active_file": 0, "total_cache": 0, "total_dirty": 0, "total_inactive_anon": 0, "total_inactive_file": 0, "total_mapped_file": 0, "total_pgfault": 2033, "total_pgmajfault": 0, "total_pgpgin": 1734, "total_pgpgout": 1724, "total_rss": 40960, "total_rss_huge": 0, "total_unevictable": 0, "total_writeback": 0, "unevictable": 0, "writeback": 0 }, "limit": 4073377792 }, "name": "/ecs-curltest-26-internalecspause-a6bcc3dbadfacfe85300", "id": "01999f2e5c6cf4df3873f28950e6278813408f281c54778efec860d0caad4854", "networks": { "eth0": { "rx_bytes": 84, "rx_packets": 2, "rx_errors": 0, "rx_dropped": 0, "tx_bytes": 84, "tx_packets": 2, "tx_errors": 0, "tx_dropped": 0 } }, "network_rate_stats": { "rx_bytes_per_sec": 0, "tx_bytes_per_sec": 0 } }, "5fc21e5b015f899d22618f8aede80b6d70d71b2a75465ea49d9462c8f3d2d3af": { "read": "2020-10-02T00:51:32.512771349Z", "preread": "2020-10-02T00:51:31.510597736Z", "pids_stats": { "current": 3 }, "blkio_stats": { "io_service_bytes_recursive": [ ], "io_serviced_recursive": [ ], "io_queue_recursive": [ ], "io_service_time_recursive": [ ], "io_wait_time_recursive": [ ], "io_merged_recursive": [ ], "io_time_recursive": [ ], "sectors_recursive": [ ] }, "num_procs": 0, "storage_stats": { }, "cpu_stats": { "cpu_usage": { "total_usage": 379075681, "percpu_usage": [ 191355275, 187720406 ], "usage_in_kernelmode": 60000000, "usage_in_usermode": 310000000 }, "system_cpu_usage": 13977800000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "precpu_stats": { "cpu_usage": { "total_usage": 378825197, "percpu_usage": [ 191104791, 187720406 ], "usage_in_kernelmode": 60000000, "usage_in_usermode": 310000000 }, "system_cpu_usage": 13975800000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "memory_stats": { "usage": 1814528, "max_usage": 6299648, "stats": { "active_anon": 606208, "active_file": 0, "cache": 0, "dirty": 0, "hierarchical_memory_limit": 134217728, "hierarchical_memsw_limit": 268435456, "inactive_anon": 0, "inactive_file": 0, "mapped_file": 0, "pgfault": 5377, "pgmajfault": 0, "pgpgin": 3613, "pgpgout": 3465, "rss": 606208, "rss_huge": 0, "total_active_anon": 606208, "total_active_file": 0, "total_cache": 0, "total_dirty": 0, "total_inactive_anon": 0, "total_inactive_file": 0, "total_mapped_file": 0, "total_pgfault": 5377, "total_pgmajfault": 0, "total_pgpgin": 3613, "total_pgpgout": 3465, "total_rss": 606208, "total_rss_huge": 0, "total_unevictable": 0, "total_writeback": 0, "unevictable": 0, "writeback": 0 }, "limit": 134217728 }, "name": "/ecs-curltest-26-curl-c2e5f6e0cf91b0bead01", "id": "5fc21e5b015f899d22618f8aede80b6d70d71b2a75465ea49d9462c8f3d2d3af", "networks": { "eth0": { "rx_bytes": 84, "rx_packets": 2, "rx_errors": 0, "rx_dropped": 0, "tx_bytes": 84, "tx_packets": 2, "tx_errors": 0, "tx_dropped": 0 } }, "network_rate_stats": { "rx_bytes_per_sec": 0, "tx_bytes_per_sec": 0 } } } ``` # 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" } ``` # Point de terminaison des métadonnées de tâches Amazon ECS version 2 **Important** Le point de terminaison des métadonnées de tâches version 2 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). À partir de la version 1.17.0 de l'agent de conteneur Amazon ECS, différentes métadonnées de tâche et [statistiques Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) sont disponibles pour les tâches qui utilisent le mode réseau `awsvpc` à un point de terminaison HTTP fourni par l'agent de conteneur Amazon ECS. Tous les conteneurs appartenant à des tâches lancées en mode `awsvpc` réseau reçoivent une IPv4 adresse locale comprise dans une plage d'adresses lien-local prédéfinie. Lorsqu'un conteneur interroge le point de terminaison des métadonnées, l'agent de conteneur Amazon ECS peut déterminer à quelles tâches le conteneur appartient en fonction de son adresse IP unique. Des métadonnées et des statistiques pour cette tâche sont alors renvoyées. ## Activation des métadonnées de tâche **Important** Le point de terminaison des métadonnées de tâches version 2 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). À partir de la version 1.17.0 de l'agent de conteneur Amazon ECS, différentes métadonnées de tâche et [statistiques Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) sont disponibles pour les tâches qui utilisent le mode réseau `awsvpc` à un point de terminaison HTTP fourni par l'agent de conteneur Amazon ECS. Tous les conteneurs appartenant à des tâches lancées en mode `awsvpc` réseau reçoivent une IPv4 adresse locale comprise dans une plage d'adresses lien-local prédéfinie. Lorsqu'un conteneur interroge le point de terminaison des métadonnées, l'agent de conteneur Amazon ECS peut déterminer à quelles tâches le conteneur appartient en fonction de son adresse IP unique. Des métadonnées et des statistiques pour cette tâche sont alors renvoyées. ### Activation des métadonnées de tâche La fonctionnalité des métadonnées de tâches version 2 est activée par défaut pour les éléments suivants : + Tâches utilisant Fargate qui ont recours à la version de plateforme v1.1.0 ou ultérieure. Pour de plus amples informations, veuillez consulter [Versions de plateforme Fargate pour Amazon ECS](platform-fargate.md). + Tâches utilisant EC2 qui utilisent également le mode réseau `awsvpc` et qui sont lancées sur l’infrastructure Linux Amazon EC2 exécutant au moins la version 1.17.0 de l’agent de conteneur Amazon ECS ou sur l’infrastructure Windows Amazon EC2 exécutant au moins la version `1.54.0` de l’agent du conteneur Amazon ECS. 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). ### Chemins de points de terminaison des métadonnées de tâches Les points de terminaison d'API suivants sont disponibles pour les conteneurs : `169.254.170.2/v2/metadata` Ce point de terminaison 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âche](#task-metadata-endpoint-v2-response). `169.254.170.2/v2/metadata/` Ce point de terminaison renvoie le JSON des métadonnées pour l'ID de conteneur Docker spécifié. `169.254.170.2/v2/metadata/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`. `169.254.170.2/v2/stats` Ce point de terminaison 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. `169.254.170.2/v2/stats/` Ce point de terminaison renvoie le JSON des statistiques Docker pour l'ID de conteneur Docker spécifié. 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âche Les informations suivantes sont renvoyées à partir de la réponse JSON du point de terminaison de métadonnées de la tâche (`169.254.170.2/v2/metadata`). `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`. ### Exemple de réponse de métadonnées de tâches 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" } ```