ECSAmazon-Aufgabenmetaden-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 ECSAmazon-Aufgabenmetaden-Endpunkt Version 4.

Wenn Sie ECS Amazon-Aufgaben verwenden, die auf gehostet werden AWS Fargate, finden Sie mehr Informationen unter Metadatenendpunkt für Aufgaben Version 3 im Amazon Elastic Container Service-Benutzerhandbuch für AWS Fargate.

Ab Version 1.21.0 des ECS Amazon-Containeragenten führt der Agent eine Umgebungsvariable ein, die ECS_CONTAINER_METADATA_URI in jeden Container einer Aufgabe aufgerufen wird. Wenn Sie den Endpunkt der Aufgaben-Metadaten Version 3 abfragen, stehen für die Aufgaben verschiedene Aufgaben-Metadaten und Docker Statistiken zur Verfügung. Bei Aufgaben, die den Netzwerkmodus bridge verwenden, stehen Netzwerkmetriken zur Verfügung, wenn die /stats-Endpunkte abgefragt werden.

Die Endpunktfunktion Version 3 für Task-Metadaten ist standardmäßig für Aufgaben aktiviert, die den Starttyp Fargate auf Plattformversion v1.3.0 oder höher verwenden, sowie für Aufgaben, die den EC2 Starttyp verwenden und in der Amazon EC2 Linux-Infrastruktur ab Version 1.21.0 des ECS Amazon-Containeragenten ausgeführt werden, oder in der Amazon EC2 Windows-Infrastruktur ab Version 1.21.0 1.54.0 des ECS Amazon-Container-Agenten ausgeführt werden und den Netzwerkmodus verwendenawsvpc. Weitere Informationen finden Sie unter Verwaltung von Amazon ECS Linux Container-Instances.

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 Aktualisieren des ECS Amazon-Container-Agenten.

Wichtig

Für Aufgaben, die den Starttyp Fargate und die Plattform-Versionen vor v1.3.0 verwenden, wird der Endpunkt von Aufgaben-Metadaten Version 2 unterstützt. Weitere Informationen finden Sie unter ECSAmazon-Aufgabenmetaden-Endpunkt Version 2.

Pfade für den Endpunkt der Aufgabenmetadaten, Version 3

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

${ECS_CONTAINER_METADATA_URI}

Dieser Pfad gibt Metadaten JSON für den Container zurück.

${ECS_CONTAINER_METADATA_URI}/task

Dieser Pfad gibt Metadaten JSON für die Aufgabe zurück, einschließlich einer Liste des Containers IDs und Namen für alle Container, die der Aufgabe zugeordnet sind. Weitere Informationen zu der Antwort für diesen Endpunkt finden Sie unter JSONAntwort auf Amazon ECS Task Metadata v3.

${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 aufgerufen werden können, eingeschlossen sind ListTagsForResourceAPI.

${ECS_CONTAINER_METADATA_URI}/stats

Dieser Pfad gibt Docker-Statistiken JSON für die angegebene Docker-Container zurück. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie ContainerStatsin der API Docker-Dokumentation.

${ECS_CONTAINER_METADATA_URI}/task/stats

Dieser Pfad gibt Docker-Statistiken JSON für alle der Aufgabe zugeordneten Container zurück. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie ContainerStatsin der Docker-DokumentationAPI.