

# EC2 のタスクで使用できる Amazon ECS タスクメタデータ
<a name="ec2-metadata"></a>

Amazon ECS コンテナエージェントでは、さまざまなタスクメタデータおよび [[ Docker ](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) ]統計を取得するメソッドを提供します。これは、タスクメタデータエンドポイントと呼ばれます。以下のバージョンが利用できます。
+ タスクメタデータエンドポイントバージョン 4 コンテナにさまざまなメタデータと Docker 統計を提供します。ネットワークレートデータも提供できます。少なくともバージョン`1.39.0`のAmazon ECS コンテナエージェントを実行しているAmazon EC2 Linuxインスタンスで起動されたAmazon ECSタスクで利用できます。`awsvpc` ネットワークモードを使用するAmazon EC2 Windows インスタンスの場合、Amazon ECS コンテナエージェントは少なくともバージョン `1.54.0` でなければなりません。詳細については、「[Amazon ECS タスクメタデータエンドポイントバージョン 4](task-metadata-endpoint-v4.md)」を参照してください。
+ タスクメタデータエンドポイントバージョン 3 コンテナにさまざまなメタデータと Docker 統計を提供します。少なくともバージョン`1.21.0`のAmazon ECS コンテナエージェントを実行しているAmazon EC2 Linuxインスタンスで起動されたAmazon ECSタスクで利用できます。`awsvpc` ネットワークモードを使用するAmazon EC2 Windows インスタンスの場合、Amazon ECS コンテナエージェントは少なくともバージョン `1.54.0` でなければなりません。詳細については、「[Amazon ECS タスクメタデータエンドポイントバージョン 3](task-metadata-endpoint-v3.md)」を参照してください。
+ タスクメタデータエンドポイントバージョン2–少なくともバージョン `1.17.0`のAmazonECS コンテナエージェントを実行しているAmazon EC2 Linuxインスタンスで起動されたAmazon ECS タスクで利用できます。`awsvpc` ネットワークモードを使用するAmazon EC2 Windows インスタンスの場合、Amazon ECS コンテナエージェントは少なくともバージョン `1.54.0` でなければなりません。詳細については、「[Amazon ECS タスクメタデータエンドポイントバージョン 2](task-metadata-endpoint-v2.md)」を参照してください。

 Amazon ECS タスクが Amazon EC2 でホストされている場合、またはタスクが `host` ネットワークモードを使用して Amazon ECS マネージドインスタンスでホストされている場合、[インスタンスメタデータサービス (IMDS) エンドポイント](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html)を使用してタスクホストのメタデータにアクセスすることもできます。次のコマンドは、タスクをホストするインスタンス内から実行すると、ホストインスタンスの ID を一覧表示します。

```
 curl http://169.254.169.254/latest/meta-data/{{instance-id}}
```

Amazon ECS タスクが Amazon EC2 上で、IPv6-only 設定でホストされている場合、IPv6 IMDS エンドポイントを使用してタスクホストのメタデータにアクセスできます。次のコマンドは、タスクをホストするインスタンス内から実行すると、IPv6 上のホストインスタンスの ID を一覧表示します。

```
 curl http://[fd00:ec2::254]/latest/meta-data/{{instance-id}}
```

IPv6 IMDS エンドポイントにアクセスするには、コンテナインスタンスで IPv6 IMDS エンドポイントを有効にし、選択した SDK の IMDS 認証情報プロバイダーを使用してメタデータサービスエンドポイントモードを `IPv6` に設定します。コンテナインスタンスの IPv6 IMDS エンドポイントを有効にする方法については、「*Amazon EC2 ユーザーガイド*」の「[インスタンスメタデータサービスのオプションを設定する](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html)」を参照してください。SDK の IMDS 認証情報プロバイダーの詳細については、*AWS SDK とツールのリファレンスガイド*の「[IMDS 認証情報プロバイダー](https://docs.aws.amazon.com/sdkref/latest/guide/feature-imds-credentials.html)」を参照してください。

**注記**  
`awsvpcTrunking` アカウント設定が有効になっている場合、IPv6 IMDS エンドポイントにはアクセスできません。`awsvpcTrunking` が有効になっている状態でコンテナインスタンスの IAM ロール認証情報にアクセスするには、代わりにタスクの IAM ロールを使用します。タスクの IAM ロールの詳細については、「[Amazon ECS タスクの IAM ロール](task-iam-roles.md)」を参照してください。

 エンドポイントから取得できる情報は、`{{instance-id}}` などのようなカテゴリに分類されます。エンドポイントを使用して取得できるホストインスタンスのメタデータのさまざまなカテゴリの詳細については、「[インスタンスメタデータのカテゴリ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html#instancedata-data-categories)」を参照してください。