Aufgabenmetadaten-Endpunkt Version 4 von Amazon ECS für Aufgaben in Amazon ECS Managed Instances

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 Amazon ECS Managed Instances wird in jeden Container einer Aufgabe eine Umgebungsvariable mit dem Namen ECS_CONTAINER_METADATA_URI_V4 injiziert. Wenn Sie den Aufgabenmetadaten-Endpunkt Version 4 abfragen, stehen für die Aufgaben verschiedene Aufgabenmetadaten und Docker-Statistiken zur Verfügung.

Der Aufgabenmetadaten-Endpunkt ist standardmäßig für alle Amazon-ECS-Aufgaben aktiviert, die in Amazon ECS Managed Instances ausgeführt werden.

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 den Aufgabenmetadaten-Endpunkt Version 4 von Amazon ECS Managed Instances

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 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 für Aufgaben in Amazon ECS Managed Instances.

${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 ContainerStatsin der Docker-API-Dokumentation.

Anmerkung

Amazon-ECS-Aufgaben in Amazon ECS Managed Instances erfordern, dass der Container für ~1 Sekunde ausgeführt wird, bevor die Container-Statistiken 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 ContainerStatsin der Docker-API-Dokumentation.

Anmerkung

Amazon-ECS-Aufgaben in Amazon ECS Managed Instances erfordern, dass der Container für ~1 Sekunde ausgeführt wird, bevor die Container-Statistiken zurückgegeben werden.

${ECS_CONTAINER_METADATA_URI_V4}/tasks

Dieser Pfad gibt Metadaten für alle Aufgaben zurück, die auf der Container-Instance ausgeführt werden. Die Antwort ist ein JSON-Array von Aufgaben-Metadatenobjekten, wobei jedes Element dieselbe Struktur wie die Antwort vom /task Endpunkt hat. Weitere Informationen zur Antwort für jede Aufgabe finden Sie unterAmazon-ECS-Aufgabenmetadaten v4 JSON-Antwort für Aufgaben in Amazon ECS Managed Instances.

Anmerkung

Dieser Endpunkt ist nur für Aufgaben verfügbar, die als Managed Daemon Service auf Amazon ECS Managed Instances ausgeführt werden.

${ECS_CONTAINER_METADATA_URI_V4}/tasks/stats

Dieser Pfad gibt Docker-Statistiken für alle Container für alle Aufgaben zurück, die auf der Container-Instance ausgeführt werden. Die Antwort ist ein JSON-Array, in dem jedes Element eine Zuordnung von Containern IDs zu ihren Docker-Statistiken für eine bestimmte Aufgabe enthält. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie ContainerStatsin der Docker-API-Dokumentation.

Anmerkung

Dieser Endpunkt ist nur für Aufgaben verfügbar, die als Managed Daemon Service auf Amazon ECS Managed Instances ausgeführt werden.