

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.

# Aufgaben-Metadaten sind für Amazon-ECS-Aufgaben in EC2 verfügbar
<a name="ec2-metadata"></a>

Der Amazon-ECS-Containeragent bietet eine Methode zum Abrufen verschiedener Task-Metadaten und [Docker-Statistiken](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats). Dies wird als Endpunkt der Aufgabenmetadaten bezeichnet. Die folgenden Versionen sind verfügbar:
+ Endpunkt für Aufgabenmetadaten Version 4: Stellt eine Vielzahl von Metadaten und Docker-Statistiken für Container bereit. Kann auch Daten zur Netzwerkrate bereitstellen. Verfügbar für Amazon-ECS-Aufgaben, die auf Amazon EC2 Linux-Instances gestartet werden, auf denen mindestens Version `1.39.0` des Amazon-ECS-Container-Agenten ausgeführt wird. Für Amazon EC2 Windows-Instances, die `awsvpc`-Netzwerkmodus verwenden, muss der Amazon-ECS-Container-Agent mindestens Version `1.54.0` sein. Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabenmetadaten-Endpunkt Version 4](task-metadata-endpoint-v4.md).
+ Endpunkt für Aufgabenmetadaten Version 3: Stellt eine Vielzahl von Metadaten und Docker-Statistiken für Container bereit. Verfügbar für Amazon-ECS-Aufgaben, die auf Amazon EC2 Linux-Instances gestartet werden, auf denen mindestens Version `1.21.0` des Amazon-ECS-Container-Agenten ausgeführt wird. Für Amazon EC2 Windows-Instances, die `awsvpc`-Netzwerkmodus verwenden, muss der Amazon-ECS-Container-Agent mindestens Version `1.54.0` sein. Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabenmetadaten-Endpunkt Version 3](task-metadata-endpoint-v3.md).
+ Endpoint für Aufgabenmetadaten Version 2: Verfügbar für Amazon-ECS-Aufgaben, die auf Amazon EC2 Linux-Instances gestartet werden, auf denen mindestens Version `1.17.0` des Amazon-ECS-Container-Agenten ausgeführt wird. Für Amazon EC2 Windows-Instances, die `awsvpc`-Netzwerkmodus verwenden, muss der Amazon-ECS-Container-Agent mindestens Version `1.54.0` sein. Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabenmetadaten-Endpunkt Version 2](task-metadata-endpoint-v2.md).

 Wenn Ihre Amazon ECS-Aufgabe auf Amazon EC2 gehostet wird oder wenn Ihre Aufgabe den `host` Netzwerkmodus verwendet und auf Amazon ECS Managed Instances gehostet wird, können Sie auch über den [Instance Metadata Service (IMDS) -Endpunkt auf die Metadaten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) des Task-Hosts zugreifen. Wenn der folgende Befehl von der Instance aus ausgeführt wird, die die Aufgabe hostet, listet er die ID der Host-Instance auf. 

```
 curl http://169.254.169.254/latest/meta-data/instance-id
```

Wenn Ihre Amazon ECS-Aufgabe auf Amazon EC2 und in einer IPv6 reinen Konfiguration gehostet wird, können Sie über den IPv6 IMDS-Endpunkt auf die Metadaten des Task-Hosts zugreifen. Wenn der folgende Befehl von der Instance aus ausgeführt wird, die die Aufgabe hostet, listet er die ID der Host-Instance auf. IPv6

```
 curl http://[fd00:ec2::254]/latest/meta-data/instance-id
```

Um auf den IPv6 IMDS-Endpunkt zuzugreifen, aktivieren Sie den IPv6 IMDS-Endpunkt auf Ihrer Container-Instance und konfigurieren Sie außerdem den Metadatendienst-Endpunktmodus mithilfe des IMDS-Anmeldeinformationsanbieters für das von Ihnen gewählte SDK. `IPv6` Weitere Informationen zur Aktivierung des IPv6 IMDS-Endpunkts für Ihre Container-Instance finden [Sie unter Configure the Instance Metadata Service options](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html) im *Amazon EC2 EC2-Benutzerhandbuch*. *Weitere Informationen zum IMDS-Anmeldeinformationsanbieter für SDKs finden Sie unter [IMDS-Anmeldeinformationsanbieter im Referenzhandbuch und im Tools-Referenzhandbuch](https://docs.aws.amazon.com/sdkref/latest/guide/feature-imds-credentials.html).AWS SDKs *

**Anmerkung**  
Auf den IPv6 IMDS-Endpunkt kann nicht zugegriffen werden, wenn die `awsvpcTrunking` Kontoeinstellung aktiviert ist. Wenn diese `awsvpcTrunking` aktiviert ist, können Sie stattdessen eine Task-IAM-Rolle verwenden, um auf die Anmeldeinformationen für die IAM-Rolle einer Container-Instance zuzugreifen. Weitere Informationen zu Aufgaben-IAM-Rollen finden Sie unter [Aufgaben-IAM-Rolle für Amazon ECS](task-iam-roles.md).

 Die Informationen, die Sie vom Endpunkt erhalten können, sind in Kategorien unterteilt, wie z. B. `instance-id`. Weitere Informationen zu den verschiedenen Kategorien von Host-Instance-Metadaten, die Sie mithilfe des Endpunkts abrufen können, finden Sie unter [Kategorien von Instance-Metadaten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html#instancedata-data-categories).

# Amazon-ECS-Aufgabenmetadaten-Endpunkt Version 4
<a name="task-metadata-endpoint-v4"></a>

Der Amazon-ECS-Container-Agent injiziert in jeden Container eine Umgebungsvariable, die als *Endpunkt für Task-Metadaten* benannt wird, die dem Container verschiedene Task-Metadaten und [Docker-Statistiken](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats) bereitstellt.

Die Aufgabenmetadaten und Statistiken zur Netzwerkrate werden an CloudWatch Container Insights gesendet und können im AWS-Managementkonsole eingesehen werden. Weitere Informationen finden Sie unter [Amazon-ECS-Container mithilfe von Container Insights mit verbesserter Beobachtbarkeit überwachen](cloudwatch-container-insights.md).

**Anmerkung**  
Amazon ECS bietet frühere Versionen des Aufgabenmetadaten an. Um in Zukunft keine neuen Endpunktversionen für Aufgabenmetadaten erstellen zu müssen, können zusätzliche Metadaten zur Ausgabe der Version 4 hinzugefügt werden. Wir werden keine vorhandenen Metadaten entfernen oder Metadatenfeldnamen ändern.

Die Umgebungsvariable wird standardmäßig in die Container von Amazon-ECS-Aufgaben injiziert, die auf Amazon EC2 Linux-Instances gestartet werden, auf denen mindestens Version `1.39.0` des Amazon-ECS-Container-Agenten ausgeführt wird. Für Amazon EC2 Windows-Instances, die `awsvpc`-Netzwerkmodus verwenden, muss der Amazon-ECS-Container-Agent mindestens Version `1.54.0` sein. Weitere Informationen finden Sie unter [Verwaltung von Linux-Container-Instances in Amazon ECS](manage-linux.md).

**Anmerkung**  
Sie können Unterstützung für dieses Feature auf Amazon EC2-Instances hinzufügen, indem Sie ältere Versionen der Amazon-ECS-Container-Agenten auf die aktuelle Version aktualisieren. Weitere Informationen finden Sie unter [Überprüfen des Amazon-ECS-Container-Agenten](ecs-agent-update.md).

Eine Beispielausgabe von Aufgabenmetadaten finden Sie unter [Beispiele für Amazon-ECS-Aufgabenmetadaten v4](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v4-examples.html).

## Pfade für Aufgabenmetadaten-Endpunkt Version 4
<a name="task-metadata-endpoint-v4-paths"></a>

Die folgenden Pfade für Aufgaben-Metadaten-Endpunkte sind für Container verfügbar:

`${ECS_CONTAINER_METADATA_URI_V4}`  
Dieser Pfad gibt Metadaten für den Container zurück.

`${ECS_CONTAINER_METADATA_URI_V4}/task`  
Dieser Pfad gibt Metadaten für die Aufgabe zurück, einschließlich einer Liste der Container IDs und Namen aller Container, die der Aufgabe zugeordnet sind. Weitere Informationen zu der Antwort für diesen Endpunkt finden Sie unter [Amazon-ECS-Aufgabenmetadaten V4 JSON-Antwort](task-metadata-endpoint-v4-response.md).

`${ECS_CONTAINER_METADATA_URI_V4}/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. Alle Fehler, die beim Abrufen der Tag-Metadaten erhalten werden, sind im `Errors`-Feld in der Antwort enthalten.  
Das `Errors`-Feld ist nur in der Antwort für Tasks enthalten, die auf Amazon EC2 Linux-Instances gehostet werden, auf denen mindestens Version `1.50.0` des Container-Agenten ausgeführt wird. Für Amazon EC2 Windows-Instances, die `awsvpc`-Netzwerkmodus verwenden, muss der Amazon-ECS-Container-Agent mindestens Version `1.54.0` sein  
Für diesen Endpunkt ist die `ecs.ListTagsForResource`-Genehmigung erforderlich.
Beachten Sie bei der Verwendung des `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags`-Endpunkts, dass jeder Aufruf bis zu zwei API-Anfragen an `ecs:ListTagsForResource` (eine für Container-Instance-Tags und eine für Aufgaben-Tags) stellt und dass alle Sidecar-Container in der Aufgabe diese Aufrufe in Ihrem Namen tätigen können. Häufige Endpunktaufrufe können zu einer API-Drosselung führen.  
Erwägen Sie die Implementierung von Caching- oder Batching-Strategien, um die Häufigkeit von Aufrufen zu reduzieren, insbesondere bei stark frequentierten Anwendungen, und das Debuggen von API-Drosselungsproblemen mithilfe von AWS CloudTrail. Informationen zu Drosselungslimits für die `ListTagsForResource`-API finden Sie unter [Drosselung für die Amazon-ECS-API anfordern](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/request-throttling.html) in der *API-Referenz für Elastic Container Service*. Weitere Informationen zum Debuggen von Amazon ECS-API-Aufrufen mithilfe von finden Sie AWS CloudTrail unter[Amazon ECS-API-Aufrufe protokollieren mit AWS CloudTrail](logging-using-cloudtrail.md).

`${ECS_CONTAINER_METADATA_URI_V4}/stats`  
Dieser Pfad gibt Docker-Statistiken für die angegebene Container zurück. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)in der Docker-API-Dokumentation.  
Für Amazon-ECS-Aufgaben, die die `awsvpc`- oder `bridge`-Netzwerkmodi nutzen, die auf Amazon EC2 Linux-Instances gehostet werden, auf denen mindestens Version `1.43.0` des Container-Agents ausgeführt werden, werden zusätzliche Netzwerkratenstatistiken in der Antwort enthalten sein. Für alle anderen Aufgaben enthält die Antwort nur die kumulativen Netzwerkstatistiken.

`${ECS_CONTAINER_METADATA_URI_V4}/task/stats`  
Dieser Pfad gibt Docker-Statistiken für alle der Aufgabe zugeordneten Container zurück. Dies kann von Sidecar-Containern verwendet werden, um Netzwerkmetriken zu extrahieren. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)in der Docker-API-Dokumentation.  
Für Amazon-ECS-Aufgaben, die die `awsvpc`- oder `bridge`-Netzwerkmodi nutzen, die auf Amazon EC2 Linux-Instances gehostet werden, auf denen mindestens Version `1.43.0` des Container-Agents ausgeführt werden, werden zusätzliche Netzwerkratenstatistiken in der Antwort enthalten sein. Für alle anderen Aufgaben enthält die Antwort nur die kumulativen Netzwerkstatistiken.

# Amazon-ECS-Aufgabenmetadaten V4 JSON-Antwort
<a name="task-metadata-endpoint-v4-response"></a>

Die folgenden Informationen werden von der JSON-Antwort des Endpunkts für Aufgabenmetadaten (`${ECS_CONTAINER_METADATA_URI_V4}/task`) zurückgegeben. Dazu gehören neben den Metadaten für jeden Container innerhalb der Aufgabe auch Metadaten, die mit der Aufgabe verknüpft sind.

`Cluster`  
Der Amazon-Ressourcenname (ARN) oder kurzer Name des Amazon-ECS-Clusters, zu dem die Aufgabe gehört.

`ServiceName`  
Der Name des Dienstes, zu dem die Aufgabe gehört. ServiceName wird für Amazon EC2- und Amazon ECS Anywhere Anywhere-Container-Instances angezeigt, wenn die Aufgabe mit einem Service verknüpft ist.  
Diese `ServiceName`-Metadaten sind nur bei Verwendung der Container-Agent-Version `1.63.1` oder höher von Amazon ECS enthalten.

`VPCID`  
Die VPC-ID der Amazon-EC2-Container-Instance. Dieses Feld wird nur für Amazon-EC2-Instances angezeigt.  
Diese `VPCID`-Metadaten sind nur bei Verwendung der Container-Agent-Version `1.63.1` oder höher von Amazon ECS enthalten.

`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 Ressourcenlimits, wie 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 (Windows) verwenden.

`LaunchType`  
Der Starttyp, den die Aufgabe verwendet. Bei der Verwendung von Clusterkapazitätsanbietern gibt dies an, ob die Aufgabe Fargate oder Amazon EC2-Infrastruktur verwendet.  
Diese `LaunchType`-Metadaten sind nur enthalten, wenn Version `1.45.0` oder höher des Amazon-ECs-Linux-Container-Agenten (Linux) oder 1.0.0 oder höher (Windows) verwendet wird.

`Containers`  
Eine Liste der Container-Metadaten für jeden Container, der der Aufgabe zugeordnet ist    
`DockerId`  
Die Docker-ID des Containers  
Wenn Sie Fargate verwenden, ist die ID ein 32-stelliger Hex gefolgt von einer 10-stelligen Zahl.  
`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.  
`LogDriver`  
Der Protokolltreiber, den der Container verwendet.  
Diese `LogDriver`-Metadaten sind nur bei Verwendung der Amazon ECS Linux-Container-Agent-Version `1.45.0` oder höher enthalten.  
`LogOptions`  
Die für den Container definierten Protokolltreiber-Optionen.  
Diese `LogOptions`-Metadaten sind nur bei Verwendung der Amazon ECS Linux-Container-Agent-Version `1.45.0` oder höher enthalten.  
`ContainerARN`  
Der Amazon-Ressourcenname (ARN) des Containers.  
Diese `ContainerARN`-Metadaten sind nur bei Verwendung der Amazon ECS Linux-Container-Agent-Version `1.45.0` oder höher enthalten.  
`Networks`  
Die Netzwerkinformationen für den Container, wie Netzwerkmodus und IP-Adresse. Dieser Parameter wird ausgelassen, wenn keine Netzwerkinformationen definiert sind.  
`RestartCount`  
Die Anzahl, wie oft ein Container neu gestartet wurde.  
Die `RestartCount`-Metadaten sind nur enthalten, wenn eine Neustartrichtlinie für den Container aktiviert ist. Weitere Informationen finden Sie unter [Einzelne Container in Amazon-ECS-Aufgaben mit Richtlinien für den Container-Neustart neu starten](container-restart-policy.md).

`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 v4
<a name="task-metadata-endpoint-v4-examples"></a>

Die folgenden Beispiele zeigen Beispielausgaben jeder der Aufgabenmetadaten-Endpunkte.

## Beispielantwort für Container-Metadaten
<a name="task-metadata-endpoint-v4-example-container-metadata-response"></a>

Beim Abfragen des Endpunkts `${ECS_CONTAINER_METADATA_URI_V4}` werden nur Metadaten zum Container selbst zurückgegeben. Im Folgenden finden Sie ein Beispiel für die Ausgabe einer Aufgabe, die als Teil eines Dienstes (MyService) ausgeführt wird.

```
{
    "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"
        }
    ]
}
```

## Beispiel für eine Aufgabenmetadatenantwort
<a name="task-metadata-endpoint-v4-example-task-metadata-response"></a>

Beim Abfragen des Endpunkts `${ECS_CONTAINER_METADATA_URI_V4}/task` werden Metadaten zu der Aufgabe zurückgegeben, zu der der Container gehört, zusätzlich zu den Metadaten für jeden Container innerhalb der Aufgabe. Im Folgenden finden Sie eine Beispielausgabe.

```
{
    "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"
                }
            ]
        }
    ]
}
```

## Beispielaufgabe mit Tags mit Metadatenantwort
<a name="task-metadata-endpoint-v4-example-taskwithtags-metadata-response"></a>

Beim Abfragen des Endpunkts `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags` werden Metadaten zu der Aufgabe zurückgegeben, einschließlich Aufgabe und Container-Instance-Tags. Im Folgenden finden Sie eine Beispielausgabe.

```
{
    "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"
                }
            ]
        }
    ]
}
```

## Beispielaufgabe mit Tags mit einer Fehler-Metadatenantwort
<a name="task-metadata-endpoint-v4-example-taskwithtags-error-metadata-response"></a>

Beim Abfragen des Endpunkts `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags` werden Metadaten zu der Aufgabe zurückgegeben, einschließlich Aufgabe und Container-Instance-Tags. Wenn beim Abrufen der Tagging-Daten ein Fehler auftritt, wird der Fehler in der Antwort zurückgegeben. Im Folgenden finden Sie eine Beispielausgabe für den Fall, dass die IAM-Rolle, die der Container-Instance zugeordnet ist, nicht über die `ecs:ListTagsForResource`-Berechtigung verfügt.

```
{
    "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"
                }
            ]
        }
    ]
}
```

## Beispielantwort für Container-Statistiken
<a name="task-metadata-endpoint-v4-example-stats-response"></a>

Beim Abfragen des Endpunkts `${ECS_CONTAINER_METADATA_URI_V4}/stats` werden Netzwerkmetriken für den Container zurückgegeben. Für Amazon-ECS-Aufgaben, die die `awsvpc`- oder `bridge`-Netzwerkmodi nutzen, die auf Amazon Amazon-EC2-Instances gehostet werden, auf denen mindestens Version `1.43.0` des Container-Agents ausgeführt werden, werden zusätzliche Netzwerkratenstatistiken in der Antwort enthalten sein. Für alle anderen Aufgaben enthält die Antwort nur die kumulativen Netzwerkstatistiken.

Im Folgenden finden Sie eine Beispielausgabe einer Amazon-ECS-Aufgabe auf Amazon EC2, die den `bridge`-Netzwerkmodus nutzt.

```
{
    "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
    }
}
```

## Beispielaufgabe Statistikantwort
<a name="task-metadata-endpoint-v4-example-task-stats-response"></a>

Beim Abfragen des Endpunkts `${ECS_CONTAINER_METADATA_URI_V4}/task/stats` werden Netzwerkmetriken zu der Aufgabe zurückgegeben, zu der der Container gehört. Im Folgenden finden Sie eine Beispielausgabe.

```
{
    "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
        }
    }
}
```

# Amazon-ECS-Aufgabenmetadaten-Endpunkt Version 3
<a name="task-metadata-endpoint-v3"></a>

**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
<a name="task-metadata-endpoint-v3-paths"></a>

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
<a name="task-metadata-endpoint-v3-response"></a>

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
<a name="task-metadata-endpoint-v3-examples"></a>

Die folgenden Beispiele zeigen Beispielausgaben der Aufgabenmetadaten-Endpunkte.

## Beispielantwort für Container-Metadaten
<a name="task-metadata-endpoint-v3-example-container-metadata-response"></a>

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
<a name="task-metadata-endpoint-v3-example-task-metadata-response"></a>

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"
}
```

# Amazon-ECS-Aufgabenmetadaten-Endpunkt Version 2
<a name="task-metadata-endpoint-v2"></a>

**Wichtig**  
Der Endpunkt der Aufgabenmetadaten Version 2 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).

Ab Version 1.17.0 des Amazon-ECS-Containeragenten sind für Aufgaben, die den `awsvpc`-Netzwerkmodus für einen HTTP-Endpunkt verwenden, der vom Amazon-ECS-Containeragenten bereitgestellt wird, verschiedene Aufgabenmetadaten und [Docker-Statistiken](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) verfügbar.

Alle Container, die zu Aufgaben gehören, die im `awsvpc` Netzwerkmodus gestartet werden, erhalten eine lokale IPv4 Adresse innerhalb eines vordefinierten Link-Local-Adressbereichs. Wenn ein Container den Metadatenendpunkt abfragt, kann der Amazon-ECS-Containeragent anhand der eindeutigen IP-Adresse die Aufgabe bestimmen, zu der der Container gehört, und gibt die Metadaten und Statistiken für diese Aufgabe zurück.

## Aktivieren von Aufgabenmetadaten
<a name="task-metadata-endpoint-v2-enable"></a>

**Wichtig**  
Der Endpunkt der Aufgabenmetadaten Version 2 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).

Ab Version 1.17.0 des Amazon-ECS-Containeragenten sind für Aufgaben, die den `awsvpc`-Netzwerkmodus für einen HTTP-Endpunkt verwenden, der vom Amazon-ECS-Containeragenten bereitgestellt wird, verschiedene Aufgabenmetadaten und [Docker-Statistiken](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) verfügbar.

Alle Container, die zu Aufgaben gehören, die im `awsvpc` Netzwerkmodus gestartet werden, erhalten eine lokale IPv4 Adresse innerhalb eines vordefinierten Link-Local-Adressbereichs. Wenn ein Container den Metadatenendpunkt abfragt, kann der Amazon-ECS-Containeragent anhand der eindeutigen IP-Adresse die Aufgabe bestimmen, zu der der Container gehört, und gibt die Metadaten und Statistiken für diese Aufgabe zurück.

### Aktivieren von Aufgabenmetadaten
<a name="task-metadata-endpoint-v2-enable"></a>

Das Feature Aufgaben-Metadaten-Version 2 ist standardmäßig für Folgendes aktiviert:
+ Aufgaben, die Fargate mit Plattformversion v1.1.0 oder höher verwenden. Weitere Informationen finden Sie unter [Fargate-Plattformversionen für Amazon ECS](platform-fargate.md).
+ Aufgaben, die EC2 und auch den `awsvpc`-Netzwerkmodus verwenden und in der Amazon-EC2-Linux-Infrastruktur ab Version 1.17.0 des Amazon-ECS-Containeragenten ausgeführt werden, oder in der Amazon-EC2-Windows-Infrastruktur ab Version `1.54.0` des Amazon-ECS-Container-Agenten ausgeführt werden. 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).

### Endpunktpfade für Aufgabenmetadaten
<a name="task-metadata-endpoint-v2-paths"></a>

Die folgenden API-Endpunkte sind für Container verfügbar:

`169.254.170.2/v2/metadata`  
Dieser Endpunkt gibt JSON-Metadaten für die Aufgabe zurück, einschließlich einer Liste der Container IDs und Namen aller Container, die der Aufgabe zugeordnet sind. Weitere Informationen zu der Antwort für diesen Endpunkt finden Sie unter [Aufgabenmetadaten-JSON-Antwort](#task-metadata-endpoint-v2-response).

`169.254.170.2/v2/metadata/<container-id>`  
Dieser Endpunkt gibt Metadaten-JSON für die angegebene Docker-Container-ID zurück.

`169.254.170.2/v2/metadata/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. 

`169.254.170.2/v2/stats`  
Dieser Endpunkt gibt Docker-Statistik-JSON 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. 

`169.254.170.2/v2/stats/<container-id>`  
Dieser Endpunkt gibt Docker-Statistik-JSON 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. 

### Aufgabenmetadaten-JSON-Antwort
<a name="task-metadata-endpoint-v2-response"></a>

Die folgenden Informationen werden von der JSON-Antwort des Endpunkts für Aufgabenmetadaten (`169.254.170.2/v2/metadata`) 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.

### Beispiel für eine Aufgabenmetadatenantwort
<a name="task-metadata-endpoint-v2-example-task-metadata-response"></a>

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"
}
```