# 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` 端点时可以使用网络指标。

对于在平台版本 v1.3.0 或更高版本上使用 Fargate 的任务，以及使用 EC2 并在运行至少 1.21.0 版本 Amazon ECS 容器代理的 Amazon EC2 Linux 基础设施或运行至少 `1.54.0` 版本 Amazon ECS 容器代理的 Amazon EC2 Windows 基础设施上启动并使用 `awsvpc` 网络模式的任务，默认启用任务元数据端点版本 3 功能。有关更多信息，请参阅 [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)。