# Amazon ECS 任务元数据 V4 JSON 响应
<a name="task-metadata-endpoint-v4-response"></a>

以下信息返回自任务元数据端点（`${ECS_CONTAINER_METADATA_URI_V4}/task`）JSON 响应。除了任务中每个容器的元数据外，还包括与任务关联的元数据。

`Cluster`  
任务所属的 Amazon ECS 集群的 Amazon 资源名称（ARN）或短名称。

`ServiceName`  
任务所属服务的名称。如果任务与服务相关联，则 Amazon EC2 和 Amazon ECS Anywhere 容器实例将显示 ServiceName。  
仅在使用 Amazon ECS 容器代理版本 `1.63.1` 或更高版本时包含 `ServiceName` 元数据。

`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` 元数据包含在内。

`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 地址。如果未定义网络信息，则省略此参数。  
`RestartCount`  
容器已重启的次数。  
仅当为容器启用了重启策略时，才会包含 `RestartCount` 元数据。有关更多信息，请参阅 [使用容器重启策略重启 Amazon ECS 任务中的单个容器](container-restart-policy.md)。

`ExecutionStoppedAt`  
任务的 `DesiredStatus` 变为 `STOPPED` 时的时间戳。这将发生在关键容器变成 `STOPPED` 时。