Recuperar o documento de identidade da instância de uma instância do Amazon EC2 - Amazon Elastic Compute Cloud

Recuperar o documento de identidade da instância de uma instância do Amazon EC2

O documento de identidade da instância para uma instância do Amazon EC2 usa um formato JSON de texto simples. Para obter uma descrição do conteúdo de um documento de identidade da instância, consulte Documentos de identidade da instância para instâncias do Amazon EC2.

Os documentos de identidade de instância são armazenados nos metadados da instância para a instância, na categoria de dados dinâmicos instance-identity/document. Você acessa o documento de identidade da instância conectando-se à instância e recuperando-o dos metadados da instância.

Você pode acessar os metadados da instância usando o endereço IPv4 169.254.169.254 ou o endereço IPv6 fd00:ec2::254. Esses são endereços locais de link, o que significa que você pode acessá-los apenas na instância. Para ter mais informações, consulte Endereços locais de link. Os exemplos nesta página usam o endereço IPv4 do IMDS: 169.254.169.254. Para recuperar os metadados de instância para instâncias do EC2 via IPv6, use fd00:ec2::254.

Para verificar a autenticidade de um documento de identidade da instância depois de recuperá-lo. Para ter mais informações, consulte Verificar documento de identidade da instância.

Para recuperar o documento de identidade da instância

Conecte-se à instância e execute o comando a seguir para acessar o documento de identidade da instância nos metadados da instância.

cURL

IMDSv2

$ 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

IMDSv1

$ curl http://169.254.169.254/latest/dynamic/instance-identity/document
PowerShell

IMDSv2

PS C:\> [string]$token = (Invoke-WebRequest -Method Put -Headers @{'X-aws-ec2-metadata-token-ttl-seconds' = '21600'} http://169.254.169.254/latest/api/token).Content
PS C:\> (Invoke-WebRequest -Headers @{'X-aws-ec2-metadata-token' = $Token} http://169.254.169.254/latest/dynamic/instance-identity/document).Content

IMDSv1

PS C:\> (Invoke-WebRequest http://169.254.169.254/latest/dynamic/instance-identity/document).Content

O seguinte é um exemplo de saída.

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