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

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

**重要**  
如果使用託管於 Amazon EC2 執行個體上的 Amazon ECS 任務，請參閱 [Amazon ECS 任務中繼資料端點](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint.html)。

從 Fargate 平台版本 `1.4.0` 開始，名為 `ECS_CONTAINER_METADATA_URI_V4` 的環境變數會插入任務中的每個容器。當您查詢任務中繼資料端點第 4 版時，有各種任務中繼資料和 [Docker 統計資訊](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)可供任務使用。

任務中繼資料端點第 4 版功能與第 3 版端點類似，但第 4 版為您的容器和任務提供其他網路中繼資料。查詢 `/stats` 端點時，也可以使用其他網路指標。

對於在使用平台版本 `1.4.0`或更新版本上執行的所有 Amazon ECS 任務 AWS Fargate ，任務中繼資料端點預設為開啟。

**注意**  
為了避免未來需要建立新的任務中繼資料端點版本，可以將其他中繼資料新增至第 4 版輸出。我們不會移除任何現有中繼資料或變更中繼資料欄位名稱。

## Fargate 任務中繼資料端點第 4 版路徑
<a name="task-metadata-endpoint-v4-fargate-paths"></a>

下列任務中繼資料端點可供容器使用：

`${ECS_CONTAINER_METADATA_URI_V4}`  
此路徑傳回容器的中繼資料。

`${ECS_CONTAINER_METADATA_URI_V4}/task`  
此路徑傳回任務的中繼資料，包括與任務相關聯之所有容器的容器 ID 和名稱清單。如需此端點之回應的詳細資訊，請參閱「[Fargate 上任務的 Amazon ECS 中繼資料第 4 版 JSON 回應](task-metadata-endpoint-v4-fargate-response.md)」。

`${ECS_CONTAINER_METADATA_URI_V4}/stats`  
此路徑傳回 Docker 容器的 Docker 統計資訊。如需每個所傳回統計資訊的詳細資訊，請參閱 Docker API 文件中的 [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)。  
上的 Amazon ECS 任務 AWS Fargate 需要容器執行約 1 秒，才能傳回容器統計資料。

`${ECS_CONTAINER_METADATA_URI_V4}/task/stats`  
此路徑傳回與任務相關聯之所有容器的 Docker 統計資訊。如需每個所傳回統計資訊的詳細資訊，請參閱 Docker API 文件中的 [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)。  
上的 Amazon ECS 任務 AWS Fargate 需要容器執行約 1 秒，才能傳回容器統計資料。