Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Amazon-ECS-Aufgabenmetadaten-Endpunkt Version 3
**Wichtig**
Der Endpunkt der Version-3-Aufgabenmetadaten wird nicht mehr aktiv verwaltet. Es wird empfohlen, den Endpunkt der Version-4-Aufgabenmetadaten zu aktualisieren, um die neuesten Metadatenendpunktinformationen zu erhalten Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabenmetadaten-Endpunkt Version 4](task-metadata-endpoint-v4.md).
Wenn Sie Amazon ECS-Aufgaben verwenden, die auf gehostet werden AWS Fargate, finden Sie unter [Amazon ECS-Aufgabenmetadaten-Endpunkt Version 3 Informationen zu Aufgaben auf Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v3-fargate.html).
Ab Version 1.21.0 des Amazon-ECS-Containeragenten führt der Agent eine Umgebungsvariable namens `ECS_CONTAINER_METADATA_URI` in jeden Container einer Aufgabe ein. Wenn Sie den Endpunkt der Aufgaben-Metadaten Version 3 abfragen, stehen für die Aufgaben verschiedene Aufgaben-Metadaten und [Docker Statistiken](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) zur Verfügung. Bei Aufgaben, die den Netzwerkmodus `bridge` verwenden, stehen Netzwerkmetriken zur Verfügung, wenn die `/stats`-Endpunkte abgefragt werden.
Das Feature für den Aufgabenmetadaten-Endpunkt Version 3 ist standardmäßig für Aufgaben aktiviert, die Fargate auf Plattformversion v1.3.0 oder höher verwenden. Sie ist zudem für Aufgaben aktiviert, die EC2 verwenden und auf einer Amazon-EC2-Linux-Infrastruktur gestartet werden, auf der mindestens Version 1.21.0 des Amazon-ECS-Container-Agenten oder auf Amazon-EC2-Windows-Infrastruktur mindestens Version `1.54.0` des Amazon-ECS-Container-Agenten ausgeführt wird und den `awsvpc`-Netzwerkmodus nutzt. Weitere Informationen finden Sie unter [Verwaltung von Linux-Container-Instances in Amazon ECS](manage-linux.md).
Sie können Unterstützung für dieses Feature auf älteren Container-Instances hinzufügen, indem Sie den Agenten auf die aktuelle Version aktualisieren. Weitere Informationen finden Sie unter [Überprüfen des Amazon-ECS-Container-Agenten](ecs-agent-update.md).
**Wichtig**
Für Aufgaben, die Fargate und die Plattformversionen vor v1.3.0 verwenden, wird der Aufgabenmetadaten-Endpunkt Version 2 unterstützt. Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabenmetadaten-Endpunkt Version 2](task-metadata-endpoint-v2.md).
## Pfade Aufgaben-Metadaten-Endpunkt Version 3
Die folgenden Aufgaben-Metadaten-Endpunkte sind für Container verfügbar:
`${ECS_CONTAINER_METADATA_URI}`
Dieser Pfad gibt JSON-Metadaten für den Container zurück.
`${ECS_CONTAINER_METADATA_URI}/task`
Dieser Pfad gibt JSON-Metadaten für die Aufgabe zurück, einschließlich einer Liste der Container IDs und Namen aller Container, die mit der Aufgabe verknüpft sind. Weitere Informationen zu der Antwort für diesen Endpunkt finden Sie unter [Amazon-ECS-Aufgabenmetadaten v3 JSON-Antwort](task-metadata-endpoint-v3-response.md).
`${ECS_CONTAINER_METADATA_URI}/taskWithTags`
Dieser Pfad gibt die Metadaten für die Aufgabe zurück, die im `/task`-Endpunkt zusätzlich zu den Task- und Container-Instance-Tags, die mit dem `ListTagsForResource`-API aufgerufen werden können, eingeschlossen sind.
`${ECS_CONTAINER_METADATA_URI}/stats`
Dieser Pfad gibt JSON-Docker-Statistiken für die angegebene Docker-Container-ID zurück. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)in der Docker-API-Dokumentation.
`${ECS_CONTAINER_METADATA_URI}/task/stats`
Dieser Pfad gibt JSON-Docker-Statistiken für alle der Aufgabe zugeordneten Container zurück. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)in der Docker-API-Dokumentation.
# Amazon-ECS-Aufgabenmetadaten v3 JSON-Antwort
Die folgenden Informationen werden von der JSON-Antwort des Endpunkts für Aufgabenmetadaten (`${ECS_CONTAINER_METADATA_URI}/task`) zurückgegeben.
`Cluster`
Der Amazon-Ressourcenname (ARN) oder kurzer Name des Amazon-ECS-Clusters, zu dem die Aufgabe gehört.
`TaskARN`
Der vollständige Amazon-Ressourcenname (ARN) der Aufgabe, zu der der Container gehört
`Family`
Die Familie der Amazon-ECS-Aufgabendefinition für die Aufgabe.
`Revision`
Die Revision der Amazon-ECS-Aufgabendefinition für die Aufgabe.
`DesiredStatus`
Der gewünschte Status der Aufgabe von Amazon ECS.
`KnownStatus`
Der bekannte Status der Aufgabe von Amazon ECS.
`Limits`
Die auf Aufgabenebene angegebenen Ressourcengrenzen, z. B. CPU (ausgedrückt in vCPUs) und Arbeitsspeicher. Dieser Parameter wird ausgelassen, wenn keine Ressourcenbegrenzungen festgelegt wurden.
`PullStartedAt`
Der Zeitstempel für den Zeitpunkt, an dem der erste Abruf des Container-Image gestartet wurde
`PullStoppedAt`
Der Zeitstempel für den Zeitpunkt, an dem der letzte Abruf des Container-Image abgeschlossen wurde
`AvailabilityZone`
Die Availability Zone, in der sich die Aufgabe befindet.
Die Availability-Zone-Metadaten sind nur für Fargate-Aufgaben verfügbar, die Plattform Version 1.4 oder höher (Linux) oder 1.0.0 oder höher (Windows) verwenden.
`Containers`
Eine Liste der Container-Metadaten für jeden Container, der der Aufgabe zugeordnet ist
`DockerId`
Die Docker-ID des Containers
`Name`
Der Name des Containers, wie er in der Aufgabendefinition festgelegt ist
`DockerName`
Der Name des Containers, der vom Docker bereitgestellt wird. Der Amazon-ECS-Containeragent generiert einen eindeutigen Namen für den Container, um Namensüberschneidungen zu vermeiden, wenn mehrere Kopien derselben Aufgabendefinition auf einer einzelnen Instance ausgeführt werden.
`Image`
Das Image für den Container
`ImageID`
Der SHA-256-Digest des Image-Manifests. Dies ist der Digest, mit dem das Image im Format `repository-url/image@sha256:digest` abgerufen werden kann.
`Ports`
Alle für den Container zugänglichen Ports. Dieser Parameter wird ausgelassen, wenn keine zugänglichen Ports verfügbar sind.
`Labels`
Alle auf den Container angewendeten Kennungen. Dieser Parameter wird ausgelassen, wenn keine angewendeten Kennungen verfügbar sind.
`DesiredStatus`
Der gewünschte Status des Containers von Amazon ECS.
`KnownStatus`
Der bekannte Status des Containers von Amazon ECS.
`ExitCode`
Der Beendigungscode für den Container. Dieser Parameter wird ausgelassen, wenn der Container nicht beendet wurde.
`Limits`
Die auf der Containerebene festgelegten Ressourcenbegrenzungen, wie CPU (ausgedrückt in vCPUs) und Speicher. Dieser Parameter wird ausgelassen, wenn keine Ressourcenbegrenzungen festgelegt wurden.
`CreatedAt`
Der Zeitstempel des Zeitpunkts, an dem der Container erstellt wurde. Dieser Parameter wird ausgelassen, wenn der Container noch nicht erstellt wurde.
`StartedAt`
Der Zeitstempel des Zeitpunkts, an dem der Container gestartet wurde. Dieser Parameter wird ausgelassen, wenn der Container noch nicht gestartet wurde.
`FinishedAt`
Der Zeitstempel des Zeitpunkts, an dem der Container angehalten wurde. Dieser Parameter wird ausgelassen, wenn der Container noch nicht angehalten wurde.
`Type`
Der Typ des Containers. Container, die in der Aufgabendefinition festgelegt sind, haben den Typ `NORMAL`. Sie können andere Containertypen ignorieren, die für die interne Bereitstellung von Aufgabenressourcen durch den Amazon-ECS-Containeragenten verwendet werden.
`Networks`
Die Netzwerkinformationen für den Container, wie Netzwerkmodus und IP-Adresse. Dieser Parameter wird ausgelassen, wenn keine Netzwerkinformationen definiert sind.
`ClockDrift`
Die Informationen über die Abweichung zwischen der Referenzzeit und der Systemzeit. Dies gilt für das Linux-Betriebssystem. Diese Funktion verwendet den Amazon Time Sync Service, um die Genauigkeit der Uhr zu messen und den Zeitfehler für Container bereitzustellen. Weitere Informationen finden Sie unter [Einstellen der Zeit für Ihre Linux-Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html) im *Amazon-EC2-Benutzerhandbuch für Linux-Instances*.
`ReferenceTime`
Die Grundlage der Taktgenauigkeit. Amazon ECS verwendet beispielsweise den globalen Standard Coordinated Universal Time (UTC) über NTP, z. B. `2021-09-07T16:57:44Z`.
`ClockErrorBound`
Das Maß des Taktfehlers, definiert als Abweichung zu UTC. Dieser Fehler ist der Unterschied in Millisekunden zwischen der Referenzzeit und der Systemzeit.
`ClockSynchronizationStatus`
Gibt an, ob der letzte Synchronisierungsversuch zwischen der Systemzeit und der Referenzzeit erfolgreich war.
Die gültigen Werte sind `SYNCHRONIZED` und ` NOT_SYNCHRONIZED`.
`ExecutionStoppedAt`
Der Zeitstempel des Zeitpunkts, an dem der `DesiredStatus` der Aufgaben zu `STOPPED` gewechselt hat. Dies tritt auf, wenn ein entscheidender Container zu `STOPPED` wechselt.
# Beispiele für Amazon-ECS-Aufgabenmetadaten v3
Die folgenden Beispiele zeigen Beispielausgaben der Aufgabenmetadaten-Endpunkte.
## Beispielantwort für Container-Metadaten
Beim Abfragen des Endpunkts `${ECS_CONTAINER_METADATA_URI}` werden nur Metadaten zum Container selbst zurückgegeben. Im Folgenden finden Sie eine Beispielausgabe.
```
{
"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"
]
}
]
}
```
## Beispiel für eine Aufgabenmetadatenantwort
Beim Abfragen des Endpunkts `${ECS_CONTAINER_METADATA_URI}/task` werden Metadaten zu der Aufgabe zurückgegeben, zu der der Container gehört. Im Folgenden finden Sie eine Beispielausgabe.
Die folgende JSON-Antwort ist für eine Aufgabe mit einem Container.
```
{
"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"
}
```