EC2 上 Amazon ECS 任務的任務中繼資料 - Amazon Elastic Container Service

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

EC2 上 Amazon ECS 任務的任務中繼資料

Amazon ECS 容器代理程式提供方法來擷取各種任務中繼資料和 Docker 統計資訊。這稱為任務中繼資料端點。以下為可用的版本：

  • 任務中繼資料端點版本 4 — 為容器提供各種中繼資料和 Docker 統計資訊。也提供網路速率資料。適用於在執行 Amazon ECS 容器代理程式至少 1.39.0 版本的 Amazon EC2 Linux 執行個體上啟動的 Amazon ECS 任務。對於使用 awsvpc 網路模式的 Amazon EC2 Windows 執行個體，Amazon ECS 容器代理程式必須至少為 1.54.0 版。如需詳細資訊，請參閱Amazon ECS 任務中繼資料端點第 4 版。

  • 任務中繼資料端點版本 3 — 為容器提供各種中繼資料和 Docker 統計資訊。適用於在執行 Amazon ECS 容器代理程式至少 1.21.0 版本的 Amazon EC2 Linux 執行個體上啟動的 Amazon ECS 任務。對於使用 awsvpc 網路模式的 Amazon EC2 Windows 執行個體，Amazon ECS 容器代理程式必須至少為 1.54.0 版。如需詳細資訊，請參閱Amazon ECS 任務中繼資料端點第 3 版。

  • 任務中繼資料端點版本 2 — 適用於在執行 Amazon ECS 容器代理程式至少 1.17.0 版本的 Amazon EC2 Linux 執行個體上啟動的 Amazon ECS 任務。對於使用 awsvpc 網路模式的 Amazon EC2 Windows 執行個體，Amazon ECS 容器代理程式必須至少為 1.54.0 版。如需詳細資訊，請參閱Amazon ECS 任務中繼資料端點第 2 版。

如果您的 Amazon ECS 任務託管在 Amazon EC2 上，或者您的任務使用 host 網路模式並託管在 Amazon ECS 受管執行個體上，您也可以使用執行個體中繼資料服務 (IMDS) 端點來存取任務主機中繼資料。當從託管任務的執行個體內執行時，下列命令會列出主機執行個體的 ID。

 curl http://169.254.169.254/latest/meta-data/instance-id

如果 Amazon ECS 任務以純 IPv6 組態託管在 Amazon EC2 上，您可以使用 IPv6 IMDS 端點存取任務主機中繼資料。當從託管該任務的執行個體內執行時，下列命令會透過 IPv6 列出主機執行個體的 ID。

 curl http://[fd00:ec2::254]/latest/meta-data/instance-id

若要存取 IPv6 IMDS 端點，請在容器執行個體上啟用 IPv6 IMDS 端點，並使用所選 SDK 的 IMDS 憑證提供者將中繼資料服務端點模式設定為 IPv6。如需有關為容器執行個體啟用 IPv6 IMDS 端點的詳細資訊，請參閱 Amazon EC2 User Guide 中的 Configure the Instance Metadata Service options。如需有關 SDK 的 IMDS 憑證提供者的詳細資訊，請參閱 AWS SDKs and Tools Reference Guide 中的 IMDS credential provider。

注意

當 awsvpcTrunking 帳戶設定啟用後，將無法存取 IPv6 IMDS 端點。若要在啟用 awsvpcTrunking 後存取容器執行個體 IAM 角色憑證，您可以改為使用任務 IAM 角色。如需關於任務 IAM 角色的詳細資訊，請參閱 Amazon ECS 任務 IAM 角色。

您可以從端點取得的資訊分為幾個類別，例如 instance-id。如需有關使用端點取得不同類別主機執行個體中繼資料的詳細資訊，請參閱 Instance metadata categories。