Récupérer le document d’identité d’une instance EC2 - Amazon Elastic Compute Cloud

Récupérer le document d’identité d’une instance EC2

Le document d’identité d’une instance Amazon EC2 utilise un format JSON en texte brut. Pour une description du contenu d’un document d’identité d’instance, consultezDocuments d’identité d’instance pour les instances Amazon EC2.

Le document d’identité de l’instance est stocké dans les métadonnées de l’instance, dans la catégorie de données dynamiques instance-identity/document. Vous accédez au document d’identité d’une instance en vous connectant à l’instance et en le récupérant à partir des métadonnées de l’instance.

Vous pouvez accéder aux métadonnées de l’instance à l’aide de l’adresse IPv4 169.254.169.254 ou de l’adresse fd00:ec2::254 IPv6. Ce sont des Adresses lien-local, ce qui signifie que vous ne pouvez y accéder que depuis l’instance. Les exemples de cette page utilisent l’adresse IPv4 de l’IMDS : 169.254.169.254. Pour récupérer les métadonnées des instances EC2 par le biais d’IPv6, utilisez fd00:ec2::254.

Pour vérifier l’authenticité du document d’identité d’une instance après l’avoir récupéré, consultez la section Vérifier le document d’identité de l’instance.

IMDSv2
Linux

Exécutez la commande suivante à partir de votre instance Linux pour récupérer le document d’identité de l’instance.

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

Exécutez l’applet de commande suivant à partir de votre instance Windows pour récupérer le document d’identité de l’instance.

[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

Exécutez la commande suivante à partir de votre instance Linux pour récupérer le document d’identité de l’instance.

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

Exécutez l’applet de commande suivant à partir de votre instance Windows pour récupérer le document d’identité de l’instance.

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

Voici un exemple de sortie.

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