本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon ECS 任務中繼資料端點第 3 版
**重要**
不再積極維護任務中繼資料第 3 版端點。建議您更新任務中繼資料第 4 版端點，以取得最新的中繼資料端點資訊。如需詳細資訊，請參閱[Amazon ECS 任務中繼資料端點第 4 版](task-metadata-endpoint-v4.md)。
如果您使用託管在 上的 Amazon ECS 任務 AWS Fargate，請參閱 [Amazon ECS 任務中繼資料端點第 3 版，以取得 Fargate 上的任務](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v3-fargate.html)。
從 Amazon ECS 容器代理程式 1.21.0 版開始，代理程式會將稱為 `ECS_CONTAINER_METADATA_URI` 的環境變數插入任務中的每個容器。當您查詢任務中繼資料第 3 版端點時，有各種任務中繼資料和 [Docker 統計資訊](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)可供任務使用。對於使用 `bridge` 網路模式的工作，查詢 `/stats` 端點時，可使用網路指標。
依預設，對於在平台版本 1.3.0 或更新版本上使用 Fargate 的任務，以及使用 EC2 的任務，會啟用任務中繼資料端點第 3 版功能，並在至少執行 Amazon ECS 容器代理程式 1.21.0 版的 Amazon EC2 Linux 基礎結構，或者在至少執行 Amazon ECS 容器代理程式 `1.54.0` 版的 Amazon EC2 Windows 基礎結構上啟動該功能，並使用 `awsvpc` 網路模式。如需詳細資訊，請參閱[Amazon ECS Linux 容器執行個體管理](manage-linux.md)。
您可以將代理更新為最新版本，以在舊容器執行個體上新增此功能的支援。如需詳細資訊，請參閱[更新 Amazon ECS 容器代理程式](ecs-agent-update.md)。
**重要**
對於使用 Fargate 且平台版本低於 1.3.0 版的任務，支援任務中繼資料第 2 版端點。如需詳細資訊，請參閱[Amazon ECS 任務中繼資料端點第 2 版](task-metadata-endpoint-v2.md)。
## 任務中繼資料端點第 3 版路徑
下列任務中繼資料端點可供容器使用：
`${ECS_CONTAINER_METADATA_URI}`
此路徑傳回容器的 JSON 中繼資料。
`${ECS_CONTAINER_METADATA_URI}/task`
此路徑傳回任務的中繼資料 JSON，包括與任務相關聯之所有容器的容器 ID 和名稱清單。如需此端點之回應的詳細資訊，請參閱「[Amazon ECS 任務中繼資料第 3 版 JSON 回應](task-metadata-endpoint-v3-response.md)」。
`${ECS_CONTAINER_METADATA_URI}/taskWithTags`
除了可使用 `ListTagsForResource` API 擷取的任務和容器執行個體標籤之外，此路徑還會傳回包含在 `/task` 端點內的任務的中繼資料。
`${ECS_CONTAINER_METADATA_URI}/stats`
此路徑傳回特定 Docker 容器的 Docker 統計資訊 JSON。如需每個所傳回統計資訊的詳細資訊，請參閱 Docker API 文件中的 [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)。
`${ECS_CONTAINER_METADATA_URI}/task/stats`
此路徑傳回與任務相關聯之所有容器的 Docker 統計資訊 JSON。如需每個所傳回統計資訊的詳細資訊，請參閱 Docker API 文件中的 [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)。