Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Recupero del documento di identità dell’istanza per un’istanza EC2
<a name="retrieve-iid"></a>

Il documento di identità di un'istanza Amazon EC2 utilizza un formato JSON di testo semplice. Per una descrizione del contenuto del documento di identità di un'istanza, consulta. [Documenti di identità dell'istanza per le istanze Amazon EC2](instance-identity-documents.md)

Il documento di identità dell’istanza è memorizzato nei metadati per l’istanza, nella categoria dei dati dinamici `instance-identity/document`. Puoi accedere al documento di identità dell'istanza connettendoti all'istanza e recuperandolo dai metadati dell'istanza.

Puoi accedere ai metadati dell'istanza utilizzando l'indirizzo IPv4 169.254.169.254 o l'indirizzo IPv6 fd00:ec2::254. Si tratta di [Indirizzi link local](using-instance-addressing.md#link-local-addresses), il che significa che puoi accedervi solo dall’istanza. Negli esempi riportati in questa pagina viene utilizzato l'indirizzo IPv4 del servizio di metadati dell'istanza (IMDS): 169.254.169.254. Per recuperare i metadati dell’istanza per le istanze EC2 su IPv6, utilizza fd00:ec2::254.

Per verificare l’autenticità del documento di identità di un’istanza dopo averlo recuperato, consulta [Verifica documento di identità dell'istanza](verify-iid.md).

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

**Linux**  
Esegui il comando seguente dall’istanza Linux per recuperare il documento d’identità dell’istanza.

```
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**  
Esegui il cmdlet seguente dall’istanza Windows per recuperare il documento d’identità dell’istanza.

```
[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**  
Esegui il comando seguente dall’istanza Linux per recuperare il documento d’identità dell’istanza.

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

**Windows**  
Esegui il cmdlet seguente dall’istanza Windows per recuperare il documento d’identità dell’istanza.

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

------

Di seguito è riportato un output di esempio.

```
{
    "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"
}
```