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

# 擷取 EC2 執行個體的執行個體身分文件
<a name="retrieve-iid"></a>

Amazon EC2 執行個體的執行個體身分文件是使用純文字 JSON 格式。如需執行個體身分文件內容的說明，請參閱 [Amazon EC2 執行個體的執行個體身分文件](instance-identity-documents.md)。

執行個體身分文件會存放在執行個體的執行個體中繼資料中 (位於 `instance-identity/document` 動態資料類別中)。您可以連線至執行個體並從執行個體中繼資料擷取執行個體，藉此存取執行個體的執行個體身分文件。

您可以使用 IPv4 地址 169.254.169.254 或 IPv6 地址 fd00:ec2::254 來存取執行個體中繼資料。這些是 [Link-local 地址](using-instance-addressing.md#link-local-addresses)，這表示您只能從執行個體加以存取。本頁面的範例使用 IMDS 的 IPv4 地址：169.254.169.254。若要透過 IPv6 擷取 EC2 執行個體的執行個體中繼資料，請使用 fd00:ec2::254。

要在擷取執行個體身分文件之後，驗證執行個體身分文件的真實性，請參閱 [驗證執行個體身分文件](verify-iid.md)。

------
#### [ IMDSv2 ]

**Linux**  
若要擷取執行個體身分文件，請從您的 Linux 執行個體執行下列命令。

```
TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
    && curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/dynamic/instance-identity/document
```

**Windows**  
若要擷取執行個體身分文件，請從您的 Windows 執行個體執行下列 cmdlet。

```
[string]$token = (Invoke-WebRequest -Headers @{'X-aws-ec2-metadata-token-ttl-seconds' = '21600'} `
    -Method PUT -Uri 'http://169.254.169.254/latest/api/token' -UseBasicParsing).Content
```

```
(Invoke-WebRequest -Headers @{'X-aws-ec2-metadata-token' = $token} `
    -Uri 'http://169.254.169.254/latest/dynamic/instance-identity/document' -UseBasicParsing).Content
```

------
#### [ IMDSv1 ]

**Linux**  
若要擷取執行個體身分文件，請從您的 Linux 執行個體執行下列命令。

```
curl http://169.254.169.254/latest/dynamic/instance-identity/document
```

**Windows**  
若要擷取執行個體身分文件，請從您的 Windows 執行個體執行下列 cmdlet。

```
(Invoke-WebRequest http://169.254.169.254/latest/dynamic/instance-identity/document).Content
```

------

以下為範例輸出。

```
{
    "devpayProductCodes" : null,
    "marketplaceProductCodes" : [ "1abc2defghijklm3nopqrs4tu" ], 
    "availabilityZone" : "us-west-2b",
    "privateIp" : "10.158.112.84",
    "version" : "2017-09-30",
    "instanceId" : "i-1234567890abcdef0",
    "billingProducts" : null,
    "instanceType" : "t2.micro",
    "accountId" : "123456789012",
    "imageId" : "ami-5fb8c835",
    "pendingTime" : "2016-11-19T16:32:11Z",
    "architecture" : "x86_64",
    "kernelId" : null,
    "ramdiskId" : null,
    "region" : "us-west-2"
}
```