Endpunkt für ECS Amazon-Aufgabenmetadaten, 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 Endpunkt für ECS Amazon-Aufgabenmetadaten, Version 4.

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

Ab Version 1.21.0 des ECS Amazon-Container-Agenten injiziert der Agent ECS_CONTAINER_METADATA_URI in jeden Container einer Aufgabe eine Umgebungsvariable, die 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 Funktion für Aufgabenmetadaten, Endpunkt Version 3, ist standardmäßig für Aufgaben aktiviert, die den Starttyp Fargate auf der Plattformversion v1.3.0 oder höher verwenden, und für Aufgaben, die den EC2 Starttyp verwenden und auf einer Amazon EC2 Linux-Infrastruktur mit mindestens Version 1.21.0 des ECS Amazon-Container-Agenten oder auf einer Amazon EC2 Windows-Infrastruktur gestartet werden, auf der mindestens Version 1.54.0 des ECS Amazon-Container-Agenten ausgeführt wird und den Netzwerkmodus verwendetawsvpc. 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 Den ECS Amazon-Container-Agenten aktualisieren.

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 Endpunkt für ECS Amazon-Aufgabenmetadaten, 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 der Container IDs und Namen aller 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 enthalten sind, zusätzlich zu den Aufgaben- und Container-Instanz-Tags, die mit dem abgerufen werden können ListTagsForResourceAPI.

${ECS_CONTAINER_METADATA_URI}/stats

Dieser Pfad gibt Docker-Statistiken JSON für den jeweiligen 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 Container zurück, die der Aufgabe zugeordnet sind. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie ContainerStatsin der Docker-DokumentationAPI.