Amazon ECS タスクメタデータエンドポイントバージョン 3

重要

タスクメタデータのバージョン 3 エンドポイントは、現在アクティブにメンテナンスされていません。タスクメタデータバージョン 4 エンドポイントを更新して、最新のメタデータエンドポイント情報を取得することをお勧めします。詳細については、「Amazon ECS タスクメタデータエンドポイントバージョン 4」を参照してください。

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

Amazon ECS コンテナエージェントの 1.21.0 バージョン以降では、エージェントはタスクの各コンテナに、環境変数 ECS_CONTAINER_METADATA_URI を挿入します。タスクメタデータバージョン 3 エンドポイントに対してクエリを実行すると、さまざまなタスクメタデータおよび Docker 統計 をタスクで利用できます。bridge ネットワークモードを使用するタスクの場合、/stats エンドポイントにクエリを実行する際にネットワークメトリクスを使用できます。

タスクメタデータエンドポイントバージョン 3 の機能は、プラットフォームのバージョン v1.3.0 以降で 1.54.0 Fargate 起動タイプを使用するタスクと、EC2 起動タイプを使用し、Amazon EC2 コンテナエージェントのバージョン 1.21.0 以降を実行する Amazon EC2 Linux インフラストラクチャで起動されるタスク、または、Amazon EC2コンテナエージェントの最新のバージョン awsvpc を実行するAmazon ECS Windows インフラストラクチャで起動され、ネットワークモードで使用するタスクは、デフォルトで有効になります。詳細については、「Amazon ECS Linux コンテナインスタンスの管理」を参照してください。

エージェントを最新バージョンに更新することで、古いコンテナインスタンスにこの機能のサポートを追加できます。詳細については、「Amazon ECS コンテナエージェントをアップデートする」を参照してください。

重要

Fargate 起動タイプおよびプラットフォーム v1.3.0 以前を使用するタスクでは、タスクメタデータバージョン 2 エンドポイントはサポートされています。詳細については、「Amazon ECS タスクメタデータエンドポイントバージョン 2」を参照してください。

タスクメタデータエンドポイントバージョン 3 パス

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

${ECS_CONTAINER_METADATA_URI}

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

${ECS_CONTAINER_METADATA_URI}/task

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

${ECS_CONTAINER_METADATA_URI}/taskWithTags

このパスは、ListTagsForResource API を使用して取得できるタスクとコンテナインスタンスタグに加えて、/task エンドポイントに含まれるタスクのメタデータを返します。

${ECS_CONTAINER_METADATA_URI}/stats

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

${ECS_CONTAINER_METADATA_URI}/task/stats

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