Amazon-ECS-Aufgabenmetaden-Endpunkt Version 4 für Aufgaben in Fargate - Amazon Elastic Container Service

Amazon-ECS-Aufgabenmetaden-Endpunkt Version 4 für Aufgaben in Fargate

Wichtig

Wenn Sie Amazon-ECS-Aufgaben verwenden, die auf Amazon-EC2-Instances gehostet werden, finden Sie weitere Informationen unter Aufgabenmetadaten-Endpunkt von Amazon ECS.

Ab Fargate-Plattformversion 1.4.0 wird in jeden Container einer Aufgabe eine Umgebungsvariable mit dem Namen ECS_CONTAINER_METADATA_URI_V4 eingeschleust. Wenn Sie den Aufgabenmetadaten-Endpunkt Version 4 abfragen, stehen für die Aufgaben verschiedene Aufgabenmetadaten und Docker-Statistiken zur Verfügung.

Der Aufgabenmetadaten-Endpunkt Version 4 funktioniert wie der Endpunkt der Version 3, stellt jedoch zusätzliche Netzwerkmetadaten für Ihre Container und Aufgaben bereit. Zusätzliche Netzwerkmetriken sind ebenfalls verfügbar, wenn die /stats-Endpunkte abgefragt werden.

Der Aufgabenmetadaten-Endpunkt ist standardmäßig für alle Amazon-ECS-Aufgaben aktiviert, die auf AWS Fargate laufen, die Plattformversion 1.4.0 oder höher verwenden.

Anmerkung

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.

Pfade für Fagate-Aufgabenmetadaten-Endpunkt Version 4

Die folgenden 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 für alle Container, die der Aufgabe zugeordnet sind. Weitere Informationen zu der Antwort für diesen Endpunkt finden Sie unter Amazon-ECS-Aufgabenmetaden v4 JSON-Antwort für Aufgaben in Fargate.

${ECS_CONTAINER_METADATA_URI_V4}/stats

Dieser Pfad gibt Docker-Statistiken für den Docker-Container zurück. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie unter ContainerStats in der Docker API-Dokumentation.

Anmerkung

Amazon ECS-Aufgaben auf AWS Fargate erfordern, dass der Container für ~1 Sekunde ausgeführt wird, bevor die Containerstatistiken zurückgegeben werden.

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

Dieser Pfad gibt Docker-Statistiken für alle der Aufgabe zugeordneten Container zurück. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie unter ContainerStats in der Docker API-Dokumentation.

Anmerkung

Amazon ECS-Aufgaben auf AWS Fargate erfordern, dass der Container für ~1 Sekunde ausgeführt wird, bevor die Containerstatistiken zurückgegeben werden.