Récupérez le document d'identité d'instance pour une EC2 instance Amazon - 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érez le document d'identité d'instance pour une EC2 instance Amazon

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

les documents d'identité de l'instance sont stockés dans les métadonnées de l'instance, dans la catégorie des données instance-identity/document dynamiques. 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'IPv4adresse 169.254.169.254 ou de l'IPv6adressefd00:ec2::254. Il s'agit d'adresses locales de liens, ce qui signifie que vous ne pouvez y accéder qu'à partir de l'instance. Pour de plus amples informations, veuillez consulter Adresses lien-local. Les exemples de cette page utilisent l'IPv4adresse du IMDS :169.254.169.254. Pour récupérer les métadonnées d'instance pour EC2 les IPv6 instances, utilisez fd00:ec2::254 instead.

Pour vérifier l'authenticité du document d'identité d'une instance après l'avoir récupéré. Pour de plus amples informations, veuillez consulter Vérifier le document d'identité de l'instance.

Pour récupérer le document d'identité de l'instance

Connectez-vous à l'instance et exécutez la commande suivante pour accéder au document d'identité de l'instance à partir des métadonnées de l'instance.

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

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