# 任务元数据可用于 EC2 上的 Amazon ECS 任务 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` 的 Amazon ECS 容器代理的 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.amazonaws.cn/AWSEC2/latest/UserGuide/ec2-instance-metadata.html)访问任务主机元数据。以下命令在托管任务的实例中运行时，会列出主机实例的 ID。 ``` curl http://169.254.169.254/latest/meta-data/instance-id ``` 如果您的 Amazon ECS 任务托管在 Amazon EC2 上并采用仅 IPv6 配置，则可以使用 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.amazonaws.cn/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html)。有关 SDK 的 IMDS 凭证提供程序的更多信息，请参阅《Amazon SDK 和工具参考指南》**中的 [IMDS 凭证提供程序](https://docs.amazonaws.cn/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.amazonaws.cn/AWSEC2/latest/UserGuide/ec2-instance-metadata.html#instancedata-data-categories)。