Amazon ECS 任务元数据端点版本 3 - Amazon Elastic Container Service
任务元数据端点版本 3 路径
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon ECS 任务元数据端点版本 3

重要

任务元数据版本 3 端点不再主动维护。我们建议您更新任务元数据版本 4 端点以获取最新的元数据端点信息。有关更多信息，请参阅 Amazon ECS 任务元数据端点版本 4。

如果您使用在 Amazon Fargate 上托管的 Amazon ECS 任务，请参阅 Fargate 上任务的 Amazon ECS 任务元数据端点版本 3。

从 Amazon ECS 容器代理版本 1.21.0 开始，代理将称为 ECS_CONTAINER_METADATA_URI 的环境变量注入任务中的每个容器。在您查询任务元数据版本 3 终端节点时，将为任务提供各种任务元数据和 Docker 统计数据。对于使用 bridge 网络模式的任务，查询 /stats 终端节点时可以使用网络指标。

预设情况下，对于在平台版本v1.3.0或更高版本上使用 Fargate 启动类型的任务，以及使用 EC2 启动类型并在运行至少版本 1.21.0 的 Amazon ECS 容器代理的 Amazon EC2 Linux 基础设施或在 Amazon EC2 Windows 基础设施上启动的任务，会启用任务元数据端点版本3功能运行至少版本 1.54.0 的 Amazon ECS 容器代理并使用 awsvpc 网络模式。有关更多信息，请参阅 Amazon ECS Linux 容器实例管理。

您可以通过将代理更新为最新版本来增加在旧容器实例上对于该功能的支持。有关更多信息，请参阅 更新 Amazon ECS 容器代理。

重要

对于使用 Fargate 启动类型和 v1.3.0 之前的平台版本的任务，支持任务元数据版本 2 端点。有关更多信息，请参阅 Amazon ECS 任务元数据端点版本 2。

任务元数据端点版本 3 路径

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

${ECS_CONTAINER_METADATA_URI}

此路径返回容器的元数据 JSON。

${ECS_CONTAINER_METADATA_URI}/task

此路径返回任务的元数据 JSON，包括与任务相关的所有容器的 ID 和名称列表。有关此终端节点响应的更多信息，请参阅Amazon ECS 任务元数据 v3 JSON 响应。

${ECS_CONTAINER_METADATA_URI}/taskWithTags

除了可以使用 ListTagsForResource API 检索的任务和容器实例标记外，此路径还返回 /task 端点中包含的任务的元数据。

${ECS_CONTAINER_METADATA_URI}/stats

此路径返回特定 Docker 容器的 Docker 统计数据 JSON。有关每个返回的统计信息的更多信息，请参阅 Docker API 文档中的 ContainerStats。

${ECS_CONTAINER_METADATA_URI}/task/stats

此路径返回与任务相关的所有容器的 Docker 统计数据 JSON。有关每个返回的统计信息的更多信息，请参阅 Docker API 文档中的 ContainerStats。