

# Fargate 上任务的 Amazon ECS 任务元数据端点版本 3
<a name="task-metadata-endpoint-v3-fargate"></a>

**重要**  
任务元数据版本 3 端点不再主动维护。我们建议您更新任务元数据版本 4 端点以获取最新的元数据端点信息。有关更多信息，请参阅 [Fargate 上任务的 Amazon ECS 任务元数据端点版本 4](task-metadata-endpoint-v4-fargate.md)。

从 Fargate 平台版本 `1.1.0` 开始，名为 `ECS_CONTAINER_METADATA_URI` 的环境变量被注入到任务中的每个容器中。在您查询任务元数据版本 3 端点时，将为任务提供各种任务元数据和 [Docker 统计数据](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)。

预设情况下，Fargate 上托管的使用平台版本 `1.1.0` 或更高版本的 Amazon ECS 任务将启用任务元数据端点功能。有关更多信息，请参阅 [适用于 Amazon ECS 的 Fargate 平台版本](platform-fargate.md)。

## Fargate 上任务的任务元数据端点路径
<a name="task-metadata-endpoint-fargate-paths"></a>

以下 API 端点可用于容器：

`${ECS_CONTAINER_METADATA_URI}`  
此路径返回容器的元数据 JSON。

`${ECS_CONTAINER_METADATA_URI}/task`  
此路径返回任务的元数据 JSON，包括与任务相关的所有容器的 ID 和名称列表。有关此端点响应的更多信息，请参阅[Fargate 上任务的 Amazon ECS 任务元数据 v3 JSON 响应](task-metadata-endpoint-v3-fargate-response.md)。

`${ECS_CONTAINER_METADATA_URI}/stats`  
此路径返回特定 Docker 容器的 Docker 统计数据 JSON。有关每个返回的统计信息的更多信息，请参阅 Docker API 文档中的 [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)。

`${ECS_CONTAINER_METADATA_URI}/task/stats`  
此路径返回与任务相关的所有容器的 Docker 统计数据 JSON。有关每个返回的统计信息的更多信息，请参阅 Docker API 文档中的 [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)。