Recuperación del documento de identidad de una instancia de Amazon EC2 - Amazon Elastic Compute Cloud

Recuperación del documento de identidad de una instancia de Amazon EC2

El documento de identidad de una instancia de Amazon EC2 utiliza un formato JSON de texto sin formato. Para obtener una descripción del contenido del documento de identidad de una instancia, consulte Documentos de identidad de la instancia para las instancias de Amazon EC2.

Los documentos de identidad de la instancia se almacenan en los metadatos de la instancia, en la categoría de datos dinámicos instance-identity/document. Para acceder al documento de identidad de una instancia, debe conectarse a la instancia y recuperarlo de los metadatos de la instancia.

Puede acceder a los metadatos de la instancia mediante la dirección IPv4 169.254.169.254 o la dirección IPv6 fd00:ec2::254. Se trata de direcciones de enlace local, lo que significa que solo puede acceder a ellas desde la instancia. Para obtener más información, consulte Direcciones de enlace local. En los ejemplos de esta página, se utiliza la dirección IPv4 de IMDS: 169.254.169.254. Para recuperar los metadatos de las instancias de EC2 a través de IPv6, utilice fd00:ec2::254 en su lugar.

Para verificar la autenticidad del documento de identidad de una instancia después de recuperarlo. Para obtener más información, consulte Verifique el documento de identidad de instancia.

Recuperación del documento de identidad de la instancia

Conéctese a la instancia y ejecute el comando siguiente para acceder a su documento de identidad desde los metadatos de la instancia.

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

A continuación, se muestra un ejemplo del resultado.

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