# Amazon ECS タスクメタデータエンドポイントバージョン 3
<a name="task-metadata-endpoint-v3"></a>

**重要**  
タスクメタデータのバージョン 3 エンドポイントは、現在アクティブにメンテナンスされていません。タスクメタデータバージョン 4 エンドポイントを更新して、最新のメタデータエンドポイント情報を取得することをお勧めします。詳細については、「[Amazon ECS タスクメタデータエンドポイントバージョン 4](task-metadata-endpoint-v4.md)」を参照してください。  
AWS Fargate でホストされている Amazon ECS タスクを使用している場合は、「[Fargate 上のタスク用の Amazon ECS タスクのメタデータエンドポイントバージョン 3](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v3-fargate.html)」を参照してください。

Amazon ECS コンテナエージェントの 1.21.0 バージョン以降では、エージェントはタスクの各コンテナに、環境変数 `ECS_CONTAINER_METADATA_URI` を挿入します。タスクメタデータバージョン 3 エンドポイントに対してクエリを実行すると、さまざまなタスクメタデータおよび [Docker 統計](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) をタスクで利用できます。`bridge` ネットワークモードを使用するタスクの場合、`/stats` エンドポイントにクエリを実行する際にネットワークメトリクスを使用できます。

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

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

**重要**  
Fargate およびプラットフォームバージョン v1.3.0 以前を使用するタスクでは、タスクメタデータバージョン 2 エンドポイントはサポートされています。詳細については、「[Amazon ECS タスクメタデータエンドポイントバージョン 2](task-metadata-endpoint-v2.md)」を参照してください。

## タスクメタデータエンドポイントバージョン 3 パス
<a name="task-metadata-endpoint-v3-paths"></a>

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

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

`${ECS_CONTAINER_METADATA_URI}/task`  
このパスはタスクのメタデータ JSON を返します。これには、タスクに関連付けられたすべてのコンテナのコンテナ ID および名前のリストが含まれています。このエンドポイントのレスポンスの詳細については、「[Amazon ECS タスクメタデータ v3 JSON レスポンス](task-metadata-endpoint-v3-response.md)」を参照してください。

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

`${ECS_CONTAINER_METADATA_URI}/stats`  
このパスは特定の Docker コンテナの Docker 統計 JSON を返します。返される各統計の詳細については、Docker API ドキュメントの「[ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)」を参照してください。

`${ECS_CONTAINER_METADATA_URI}/task/stats`  
このパスはタスクに関連付けられたすべてのコンテナの Docker 統計 JSON を返します。返される各統計の詳細については、Docker API ドキュメントの「[ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)」を参照してください。