# 适用于 Amazon ECS 托管实例上的任务的 Amazon ECS 任务元数据端点版本 4
<a name="task-metadata-endpoint-v4-managed-instances"></a>

**重要**  
如果您正在使用托管在 Amazon EC2 实例上的 Amazon ECS 任务，请参阅 [Amazon ECS 任务元数据端点](https://docs.amazonaws.cn/AmazonECS/latest/developerguide/task-metadata-endpoint.html)。

从 Amazon ECS 托管实例开始，一个名为 `ECS_CONTAINER_METADATA_URI_V4` 的环境变量会被注入到任务中的每个容器中。在您查询任务元数据版本 4 端点时，将为任务提供各种任务元数据和 [Docker 统计数据](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)。

对于所有在 Amazon ECS 托管实例上运行的 Amazon ECS 任务，任务元数据端点默认情况下处于开启状态。

**注意**  
为避免将来需要创建新的任务元数据端点版本，可能会将其他元数据添加到版本 4 输出中。我们不会删除任何现有元数据或更改元数据字段名称。

## Amazon ECS 托管实例任务元数据端点版本 4 路径
<a name="task-metadata-endpoint-v4-managed-instances-paths"></a>

以下任务元数据端点可用于容器：

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

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

`${ECS_CONTAINER_METADATA_URI_V4}/stats`  
此路径返回 Docker 容器的 Docker 统计数据。有关每个返回的统计信息的更多信息，请参阅 Docker API 文档中的 [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)。  
Amazon ECS 托管实例上的 Amazon ECS 任务要求容器在返回容器统计数据之前运行约 1 秒。

`${ECS_CONTAINER_METADATA_URI_V4}/task/stats`  
此路径返回与任务相关的所有容器的 Docker 统计数据 。有关每个返回的统计信息的更多信息，请参阅 Docker API 文档中的 [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)。  
Amazon ECS 托管实例上的 Amazon ECS 任务要求容器在返回容器统计数据之前运行约 1 秒。

`${ECS_CONTAINER_METADATA_URI_V4}/tasks`  
此路径会返回容器实例上运行的所有任务的元数据。响应是一个包含任务元数据对象的 JSON 数组，其中每个元素的结构都与来自 `/task` 端点的响应相同。有关每个任务的响应的更多信息，请参阅 [Amazon ECS 托管实例上的任务的 Amazon ECS 任务元数据 v4 JSON 响应](task-metadata-endpoint-v4-managed-instances-response.md)。  
此端点仅适用于在 Amazon ECS 托管实例上以托管进程守护程序服务形式运行的任务。

`${ECS_CONTAINER_METADATA_URI_V4}/tasks/stats`  
此路径会返回容器实例上所有正在运行的任务中所有容器的 Docker 统计信息。响应是一个 JSON 数组，其中每个元素都包含给定任务的容器 ID 与其 Docker 统计信息的映射。有关每个返回的统计信息的更多信息，请参阅 Docker API 文档中的 [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)。  
此端点仅适用于在 Amazon ECS 托管实例上以托管进程守护程序服务形式运行的任务。