Récupérer le document d'identité de l'instance pour une EC2 instance - Amazon Elastic Compute Cloud

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Récupérer le document d'identité de l'instance pour une EC2 instance

Le document d'identité d'instance pour une EC2 instance Amazon 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 EC2 instances Amazon.

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' IPv4 adresse 169.254.169.254 ou de l' IPv6 adressefd00:ec2::254. 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' IPv4adresse de l'IMDS :169.254.169.254. Pour récupérer les métadonnées des EC2 instances supérieures IPv6, utilisezfd00: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"
}