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

Fargate 上任务的 Amazon ECS 任务元数据端点版本 4

重要

如果您正在使用托管在 Amazon EC2 实例上的 Amazon ECS 任务,请参阅 Amazon ECS 任务元数据端点

从 Fargate 平台版本 1.4.0 开始,名为 ECS_CONTAINER_METADATA_URI_V4 的环境变量被注入到任务中的每个容器中。在您查询任务元数据版本 4 端点时,将为任务提供各种任务元数据和 Docker 统计数据

任务元数据版本 4 端点的功能与版本 3 端点相似,但为容器和任务提供了额外的网络元数据。查询 /stats 终端节点时还可以使用其他网络指标。

默认情况下,对于使用平台版本 1.4.0 或更高版本在 Amazon Fargate 上运行的所有 Amazon ECS 任务,都会启用任务元数据端点。

注意

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

Fargate 任务元数据端点版本 4 路径

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

${ECS_CONTAINER_METADATA_URI_V4}

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

${ECS_CONTAINER_METADATA_URI_V4}/task

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

${ECS_CONTAINER_METADATA_URI_V4}/stats

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

注意

Amazon Fargate 上的 Amazon ECS 任务要求容器在返回容器统计数据之前运行约 1 秒。

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

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

注意

Amazon Fargate 上的 Amazon ECS 任务要求容器在返回容器统计数据之前运行约 1 秒。