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

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

Amazon ECS 容器代理程式會將環境變數插入到每個容器中，稱為*任務中繼資料端點*，它為容器提供各種任務中繼資料和 [Docker 統計資訊](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)。

任務中繼資料和網路速率統計資訊會傳送至 CloudWatch Container Insights ，並可在 AWS 管理主控台中檢視。如需詳細資訊，請參閱[使用具有增強可觀測性的 Container Insights 監控 Amazon ECS](cloudwatch-container-insights.md)。

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

環境變數會預設插入至 Amazon ECS 任務的容器中，這些任務在執行 Amazon ECS 容器代理程式至少 `1.39.0` 版的 Amazon EC2 Linux 執行個體上啟動。對於使用 `awsvpc` 網路模式的 Amazon EC2 Windows 執行個體，Amazon ECS 容器代理程式必須至少為 `1.54.0` 版。如需詳細資訊，請參閱[Amazon ECS Linux 容器執行個體管理](manage-linux.md)。

**注意**  
使用較舊版本的 Amazon ECS 容器代理程式可在 Amazon EC2 執行個體上新增此功能的支援，方法是將代理程式更新為最新版本。如需詳細資訊，請參閱[更新 Amazon ECS 容器代理程式](ecs-agent-update.md)。

如需任務中繼資料範例輸出，請參閱 [Amazon ECS 任務中繼資料第 4 版範例](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v4-examples.html)。

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

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

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

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

`${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags`  
除了可使用 `ListTagsForResource` API 擷取的任務和容器執行個體標籤之外，此路徑還會傳回包含在 `/task` 端點內的任務的中繼資料。擷取標籤中繼資料時收到的任何錯誤都會包含在回應的 `Errors` 欄位中。  
`Errors` 欄位僅位於執行容器代理程式至少 `1.50.0` 版本的 Amazon EC2 Linux 執行個體中託管的任務回應中。對於使用 `awsvpc` 網路模式的 Amazon EC2 Windows 執行個體，Amazon ECS 容器代理程式必須至少為 `1.54.0` 版。  
此端點需要 `ecs.ListTagsForResource` 許可。
使用 `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags` 端點時，請注意每次呼叫最多會向 `ecs:ListTagsForResource` 發出兩個 API 請求 (一個用於容器執行個體標籤，另一個用於任務標籤)，並且任務中的任何邊車容器都可代您進行這些呼叫。頻繁的端點呼叫可能會導致 API 限流。  
請考慮實作快取或批次處理策略來降低呼叫頻率，尤其是在高流量應用程式中，同時使用 AWS CloudTrail對 API 限流問題進行偵錯。如需 `ListTagsForResource` API 限流限制的相關資訊，請參閱 *Amazon Elastic Container Service API Reference* 中的 [Request throttling for the Amazon ECS API](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/request-throttling.html)。如需使用 偵錯 Amazon ECS API 呼叫的詳細資訊 AWS CloudTrail，請參閱 [使用 記錄 Amazon ECS API 呼叫 AWS CloudTrail](logging-using-cloudtrail.md)。

`${ECS_CONTAINER_METADATA_URI_V4}/stats`  
此路徑傳回特定容器的 Docker 統計資訊。如需每個所傳回統計資訊的詳細資訊，請參閱 Docker API 文件中的 [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)。  
對於使用 `awsvpc` 或 `bridge` 網路模式、託管於執行容器代理程式至少 `1.43.0` 版本的 Amazon EC2 Linux 執行個體中的 Amazon ECS 任務，回應中會包含額外的網路速率統計資訊。對於所有其他任務，回應只會包含累積的網路統計資訊。

`${ECS_CONTAINER_METADATA_URI_V4}/task/stats`  
此路徑傳回與任務相關聯之所有容器的 Docker 統計資訊。附屬容器可使用該資訊來擷取網路指標。如需每個所傳回統計資訊的詳細資訊，請參閱 Docker API 文件中的 [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)。  
對於使用 `awsvpc` 或 `bridge` 網路模式、託管於執行容器代理程式至少 `1.43.0` 版本的 Amazon EC2 Linux 執行個體中的 Amazon ECS 任務，回應中會包含額外的網路速率統計資訊。對於所有其他任務，回應只會包含累積的網路統計資訊。