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 4
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
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.