本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Fargate 上任務的 Amazon ECS 中繼資料第 4 版 JSON 回應
<a name="task-metadata-endpoint-v4-fargate-response"></a>

任務中繼資料端點 (`${ECS_CONTAINER_METADATA_URI_V4}/task`) JSON 回應會傳回下列中繼資料。

`Cluster`  
任務所屬 Amazon ECS 叢集的 Amazon Resource Name (ARN) 或簡短名稱。

`ServiceName`  
任務所屬的服務名稱。對於與服務相關聯的 Fargate 任務，會顯示 ServiceName。

`VPCID`  
Amazon EC2 容器執行個體的 VPC ID。此欄位僅適用於 Amazon EC2 執行個體。  
只有在使用 Amazon ECS 容器代理程式版本 `1.63.1` 或更新版本時，才包括該 `VPCID` 中繼資料。

`TaskARN`  
容器所屬任務的 Amazon Resource Name (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` 物件來變更暫時性儲存量。`ephermalStorage` 是以 GiB 為單位，而不是以 MiB 為單位。此 `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`  
容器正在使用的日誌驅動程式。  
只有在使用 Amazon ECS Linux 容器代理程式版本 `1.45.0` 或更新版本時，才包括此 `LogDriver` 中繼資料。  
`LogOptions`  
為容器定義的日誌驅動程式選項。  
只有在使用 Amazon ECS Linux 容器代理程式版本 `1.45.0` 或更新版本時，才包括此 `LogOptions` 中繼資料。  
`ContainerARN`  
容器的 Amazon Resource Name (ARN)。  
只有在使用 Amazon ECS Linux 容器代理程式版本 `1.45.0` 或更新版本時，才包括此 `ContainerARN` 中繼資料。  
`Networks`  
容器的網路資訊，例如網路模式和 IP 地址。如果未定義網路資訊，則會省略此參數。  
`Snapshotter`  
containerd 使用 snapshotter 來下載此容器映像。有效值為 `overlayfs` (為預設值) 和 `soci`，並且在使用 SOCI 索引延遲載入時使用。此參數僅適用於在 Linux 平台版本 `1.4.0` 上執行的任務。  
`RestartCount`  
容器已重新啟動的次數。  
僅在容器已啟用重新啟動政策時，才會包含 `RestartCount` 中繼資料。如需詳細資訊，請參閱[使用容器重新啟動政策在 Amazon ECS 任務中重新啟動個別容器](container-restart-policy.md)。

`ClockDrift`  
關於參考時間和系統時間之間差異的資訊。此功能使用 Amazon Time Sync Service 來衡量時鐘準確性，並提供容器的時鐘錯誤界限。如需詳細資訊，請參閱 *Amazon EC2 User Guide for Linux instances* 中的 [Set the time for your Linux instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html)。    
`ReferenceTime`  
時鐘精確度的基礎。Amazon ECS 透過 NTP 使用世界協調時間 (UTC) 的全球標準，例如 `2021-09-07T16:57:44Z`。  
`ClockErrorBound`  
時鐘誤差的測量值，定義為 UTC 的偏移。此誤差是參考時間和系統時間之間的毫秒差異。  
`ClockSynchronizationStatus`  
指出系統時間和參考時間之間最近的同步嘗試是否成功。  
有效值為 `SYNCHRONIZED` 和 ` NOT_SYNCHRONIZED`。

`ExecutionStoppedAt`  
任務 `DesiredStatus` 移至 `STOPPED` 時的時間戳記。這會在基本容器移至 `STOPPED` 時發生。