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

# EC2 上 Amazon ECS 任務的任務中繼資料
<a name="ec2-metadata"></a>

Amazon ECS 容器代理程式提供方法來擷取各種任務中繼資料和 [Docker 統計資訊](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)。這稱為任務中繼資料端點。以下為可用的版本：
+ 任務中繼資料端點版本 4 — 為容器提供各種中繼資料和 Docker 統計資訊。也提供網路速率資料。適用於在執行 Amazon ECS 容器代理程式至少 `1.39.0` 版本的 Amazon EC2 Linux 執行個體上啟動的 Amazon ECS 任務。對於使用 `awsvpc` 網路模式的 Amazon EC2 Windows 執行個體，Amazon ECS 容器代理程式必須至少為 `1.54.0` 版。如需詳細資訊，請參閱[Amazon ECS 任務中繼資料端點第 4 版](task-metadata-endpoint-v4.md)。
+ 任務中繼資料端點版本 3 — 為容器提供各種中繼資料和 Docker 統計資訊。適用於在執行 Amazon ECS 容器代理程式至少 `1.21.0` 版本的 Amazon EC2 Linux 執行個體上啟動的 Amazon ECS 任務。對於使用 `awsvpc` 網路模式的 Amazon EC2 Windows 執行個體，Amazon ECS 容器代理程式必須至少為 `1.54.0` 版。如需詳細資訊，請參閱[Amazon ECS 任務中繼資料端點第 3 版](task-metadata-endpoint-v3.md)。
+ 任務中繼資料端點版本 2 — 適用於在執行 Amazon ECS 容器代理程式至少 `1.17.0` 版本的 Amazon EC2 Linux 執行個體上啟動的 Amazon ECS 任務。對於使用 `awsvpc` 網路模式的 Amazon EC2 Windows 執行個體，Amazon ECS 容器代理程式必須至少為 `1.54.0` 版。如需詳細資訊，請參閱[Amazon ECS 任務中繼資料端點第 2 版](task-metadata-endpoint-v2.md)。

 如果您的 Amazon ECS 任務託管在 Amazon EC2 上，或者您的任務使用 `host` 網路模式並託管在 Amazon ECS 受管執行個體上，您也可以使用[執行個體中繼資料服務 (IMDS) 端點來存取任務主機中繼資料](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html)。當從託管任務的執行個體內執行時，下列命令會列出主機執行個體的 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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html)。如需有關 SDK 的 IMDS 憑證提供者的詳細資訊，請參閱 *AWS SDKs and Tools Reference Guide* 中的 [IMDS credential provider](https://docs.aws.amazon.com/sdkref/latest/guide/feature-imds-credentials.html)。

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

 您可以從端點取得的資訊分為幾個類別，例如 `{{instance-id}}`。如需有關使用端點取得不同類別主機執行個體中繼資料的詳細資訊，請參閱 [Instance metadata categories](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html#instancedata-data-categories)。