Amazon ECS マネージドインスタンスのタスク用の Amazon ECS タスクメタデータエンドポイントバージョン 4 - Amazon Elastic Container Service

Amazon ECS マネージドインスタンスのタスク用の Amazon ECS タスクメタデータエンドポイントバージョン 4

重要

Amazon EC2 インスタンスでホストされている Amazon ECS タスクを使用している場合は、「Amazon ECS タスクのメタデータエンドポイント」を参照してください。

Amazon ECS マネージドインスタンス以降、ECS_CONTAINER_METADATA_URI_V4 という環境変数がタスク内の各コンテナに挿入されます。タスクメタデータエンドポイントバージョン 4 に対してクエリを実行すると、さまざまなタスクメタデータおよび Docker 統計をタスクで利用できます。

Amazon ECS マネージドインスタンスで実行されるすべての Amazon ECS タスクについて、タスクメタデータエンドポイントはデフォルトでオンになっています。

注記

新しいタスクメタデータエンドポイントバージョンを今後作成する必要がないように、追加のメタデータをバージョン 4 の出力に追加できます。既存のメタデータが削除されたり、メタデータのフィールド名が変更されたりすることはありません。

Amazon ECS マネージドインスタンスのタスクメタデータエンドポイントバージョン 4

次のタスクメタデータエンドポイントをコンテナで使用できます。

${ECS_CONTAINER_METADATA_URI_V4}

このパスはコンテナのメタデータを返します。

${ECS_CONTAINER_METADATA_URI_V4}/task

このパスはタスクのメタデータを返します。これには、タスクに関連付けられたすべてのコンテナのコンテナ ID および名前のリストが含まれています。このエンドポイントのレスポンスの詳細については、「Amazon ECS マネージドインスタンスのタスク用の Amazon ECS タスクメタデータ v4 JSON レスポンス」を参照してください。

${ECS_CONTAINER_METADATA_URI_V4}/stats

このパスは Docker コンテナの Docker 統計を返します。返される各統計の詳細については、Docker API ドキュメントの「ContainerStats」を参照してください。

注記

Amazon ECS マネージドインスタンスの Amazon ECS タスクは、コンテナの統計を返す前にコンテナを約 1 秒間実行する必要があります。

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

このパスはタスクに関連付けられたすべてのコンテナの Docker 統計を返します。返される各統計の詳細については、Docker API ドキュメントの「ContainerStats」を参照してください。

注記

Amazon ECS マネージドインスタンスの Amazon ECS タスクは、コンテナの統計を返す前にコンテナを約 1 秒間実行する必要があります。