Fargate 上任务的 Amazon ECS 任务元数据 v4 JSON 响应
以下元数据返回自任务元数据端点 (${ECS_CONTAINER_METADATA_URI_V4}/task) JSON 响应。
Cluster-
任务所属的 Amazon ECS 群集的 Amazon Resource Name (ARN) 或短名称。
VPCID-
Amazon EC2 容器实例的 VPC ID。此字段仅针对 Amazon EC2 实例显示。
注意
仅在使用 Amazon ECS 容器代理版本
1.63.1或更高版本时包含VPCID元数据。 TaskARN-
容器所属的任务的 Amazon 资源名称（ARN）。
Family-
任务的 Amazon ECS 任务定义系列。
Revision-
任务的 Amazon ECS 任务定义修订。
DesiredStatus-
来自 Amazon ECS 的任务的所需状态。
KnownStatus-
来自 Amazon ECS 的任务的已知状态。
Limits-
在任务级别上指定的资源限制，如 CPU（以 vCPU 表示）和内存。如果未定义资源限制，则省略此参数。
PullStartedAt-
开始提取第一个容器映像时的时间戳。
PullStoppedAt-
完成提取最后一个容器映像时的时间戳。
AvailabilityZone-
任务所在的可用区。
注意
可用区元数据仅适用于使用平台版本 1.4 或更高版本（Linux）或者 1.0.0（Windows）的 Fargate 任务。
LaunchType-
任务使用的启动类型。使用集群容量提供程序时，这表明任务使用的是 Fargate 还是 EC2 基础设施。
注意
仅在使用 Amazon ECS Linux 容器代理版本
1.45.0或更高版本（Linux）或者 1.0.0 或更高版本（Windows）时将该LaunchType元数据包含在内。 EphemeralStorageMetrics-
此任务短暂存储的预留大小和当前使用情况。
注意
Fargate 可保留磁盘空间。该磁盘空间仅由 Fargate 使用。您无需为此付费。它没有显示在这些指标中。但是，您可以在
df等其他工具中看到这种额外的存储空间。Utilized-
此任务的当前短暂存储使用量（MiB 为单位）。
Reserved-
此任务的预留短暂存储（MiB 为单位）。无法在正在运行的任务中更改短暂存储大小。您可以在任务定义中指定的
ephermalStorage对象以更改短暂存储量。以 GiB 而不是 MiB 为单位指定ephermalStorage。ephermalStorage和EphemeralStorageMetrics仅适用于 Fargate Linux 平台 1.4.0 或更高版本上。
Containers-
与任务关联的每个容器的容器元数据列表。
DockerId-
容器的 Docker ID。
当您使用 Fargate 时，id 是一个 32 位十六进制，后面是 10 位数字。
Name-
任务定义中所指定的容器的名称。
DockerName-
提供给 Docker 的容器的名称。Amazon ECS 容器代理为容器生成一个唯一名称，以避免相同任务定义的多个副本在一个实例上运行时发生名称冲突。
Image-
容器的映像。
ImageID-
映像清单的 SHA-256 摘要。这是可用于通过
repository-url/image@sha256:digest格式拉取映像的摘要。 Ports-
对于容器公开的任何端口。如果没有公开的端口，则省略此参数。
Labels-
应用到容器的任何标签。如果没有应用的标签，则省略此参数。
DesiredStatus-
来自 Amazon ECS 的容器的所需状态。
KnownStatus-
来自 Amazon ECS 的容器的已知状态。
ExitCode-
容器的退出代码。如果没有容器退出，则省略此参数。
Limits-
在容器级别上指定的资源限制，如 CPU（以 CPU 单位表示）和内存。如果未定义资源限制，则省略此参数。
CreatedAt-
创建容器时的时间戳。如果尚未创建容器，则省略此参数。
StartedAt-
容器启动时的时间戳。如果尚未启动容器，则省略此参数。
FinishedAt-
容器停止时的时间戳。如果尚未停止容器，则省略此参数。
Type-
容器的类型。在您的任务定义中指定的容器属于
NORMAL类型。您可以省略其他被 Amazon ECS 容器代理用来进行内部任务资源预配置的容器类型。 LogDriver-
容器使用的日志驱动程序。
注意
该
LogDriver元数据仅在使用Amazon ECS Linux 容器代理版本时包含1.45.0或更高版本。 LogOptions-
为容器定义的日志驱动程序选项。
注意
该
LogOptions元数据仅在使用Amazon ECS Linux 容器代理版本时包含1.45.0或更高版本。 ContainerARN-
容器的 Amazon 资源名称（ARN）。
注意
该
ContainerARN元数据仅在使用Amazon ECS Linux 容器代理版本时包含1.45.0或更高版本。 Networks-
容器的网络信息，如网络模式和 IP 地址。如果未定义网络信息，则省略此参数。
Snapshotter-
containerd 用于下载此容器映像的 snapshotter。有效值为
overlayfs（默认值）和延迟加载 SOCI 索引时使用的soci。该参数仅适用于在 Linux 平台版本1.4.0上运行的任务。 RestartCount-
容器已重启的次数。
注意
仅当为容器启用了重启策略时，才会包含
RestartCount元数据。有关更多信息，请参阅 使用容器重启策略重启 Amazon ECS 任务中的单个容器。
ClockDrift-
有关参考时间和系统时间之间差异的信息。此功能使用 Amazon Time Sync Service 来测量时钟精度，并提供容器绑定的时钟误差。有关更多信息，请参阅《适用于 Linux 实例的 Amazon EC2 用户指南》中的为您的 Linux 实例设定时间。
ReferenceTime-
时钟准确度的基础。Amazon ECS 通过 NTP 使用协调世界时（UTC）全球标准，例如
2021-09-07T16:57:44Z。 ClockErrorBound-
时钟误差的度量，定义为与 UTC 的偏移量。此错误是参考时间和系统时间之间的差异（以毫秒为单位）。
ClockSynchronizationStatus-
指示系统时间和参考时间之间的最近一次同步尝试是否成功。
有效值为
SYNCHRONIZED和NOT_SYNCHRONIZED。
ExecutionStoppedAt-
任务的
DesiredStatus变为STOPPED时的时间戳。这将发生在关键容器变成STOPPED时。