Catégories de métadonnées d'instance - Amazon Elastic Compute Cloud

Catégories de métadonnées d'instance

Les métadonnées d'instance sont divisées en plusieurs catégories. Pour récupérer les métadonnées d'instance, vous spécifiez la catégorie dans la demande et les métadonnées sont renvoyées dans la réponse.

Lorsque de nouvelles catégories sont publiées, un nouveau build de métadonnées d'instance est créé avec un nouveau numéro de version. Dans le tableau suivant, la colonne Version when category was released (Version lors de la publication de la catégorie) indique la version du build lorsqu'une catégorie de métadonnées d'instance a été publiée. Pour éviter de devoir mettre à jour votre code chaque fois qu'Amazon EC2 publie une nouvelle version de métadonnées d'instance, utilisez latest au lieu du numéro de version dans vos demandes de métadonnées. Pour plus d'informations, consultez Obtenir les versions disponibles des métadonnées d'instance.

Lorsque Amazon EC2 libère une nouvelle catégorie de métadonnées d'instance, les métadonnées d'instance de la nouvelle catégorie peuvent ne pas être disponibles pour les instances existantes. Avec une instance basée sur le système Nitro, vous ne pouvez récupérer les métadonnées de l'instance que pour les catégories qui étaient disponibles au lancement. Pour une instance avec l'hyperviseur Xen, vous pouvez l'arrêter puis la démarrer afin de mettre à jour les catégories disponibles pour cette instance.

Le tableau ci-après répertorie les catégories de métadonnées d'instance. Certains noms de catégorie incluent des espaces réservés pour les données, qui sont propres à votre instance. Par exemple, mac représente l'adresse MAC de l'interface réseau. Quand vous récupérez les métadonnées de l'instance, vous devez remplacer les espaces réservés par des valeurs réelles.

Catégorie Description Version lors de la publication de la catégorie
ami-id L'ID d'AMI utilisé pour lancer l'instance. 1.0
ami-launch-index Si vous avez démarré plus d'une instance en même temps, cette valeur indique l'ordre dans lequel l'instance a été lancée. La valeur 0 indique la première instance lancée. 1.0
ami-manifest-path Chemin d'accès du fichier manifeste d'AMI dans Amazon S3. Si vous avez utilisé une AMI basée sur Amazon EBS pour lancer l'instance, le résultat retourné est unknown. 1.0
ancestor-ami-ids Les ID d'AMI de toutes les instances qui ont été regroupées pour créer cette AMI. Cette valeur n'existera que si le fichier manifeste d'AMI contenait une clé ancestor-amis. 2007-10-10
autoscaling/target-lifecycle-state

Valeur indiquant l'état cible du cycle de vie Auto Scaling vers lequel une instance Auto Scaling est en train de passer. Présent lorsque l'instance passe à l'un des états de cycle de vie cibles après le 10 mars 2022. Valeurs possibles : Detached | InService | Standby | Terminated | Warmed:Hibernated | Warmed:Running | Warmed:Stopped | Warmed:Terminated. Consultez Récupérer l'état du cycle de vie cible par le biais des métadonnées d'instance dans le Guide de l'utilisateur Amazon EC2 Auto Scaling.

15-07-2021
block-device-mapping/ami Le périphérique virtuel qui contient le système de fichiers racine/démarrage. 2007-12-15
block-device-mapping/ebsN Les périphériques virtuels associés à tout volume Amazon EBS. Les volumes Amazon EBS ne sont disponibles dans les métadonnées que s'ils étaient présents au moment du lancement ou lorsque l'instance a été démarrée pour la dernière fois. Le N indique l'index du volume Amazon EBS (tel que ebs1 ou ebs2). 2007-12-15
block-device-mapping/ephemeralN Les appareils virtuels pour les volumes de stockage d'instances non NVMe. Le N indique l'index de chaque volume. Le nombre de volumes de stockage d'instances dans le mappage d'appareils en bloc peut ne pas correspondre au nombre réel de volumes de stockage d'instances pour l'instance. Le type d'instance détermine le nombre de volumes de stockage d'instances disponibles pour une instance. Si le nombre de volumes de stockage d'instances dans un mappage d'appareils en bloc dépasse le nombre disponible pour une instance, les volumes de stockage d'instances supplémentaires sont ignorés. 2007-12-15
block-device-mapping/root Les périphériques ou partitions virtuels associés aux périphériques ou partitions racines sur le périphérique virtuel où le système de fichiers racine (/ ou C:) est associé avec l'instance donnée. 2007-12-15
block-device-mapping/swap Les périphériques virtuels associés avec swap. Pas toujours présents. 2007-12-15
elastic-gpus/associations/elastic-gpu-id Si un Elastic GPU est attaché à l'instance, contient une chaîne JSON avec des informations sur l'Elastic GPU, notamment son ID et ses informations de connexion. 2016-11-30
elastic-inference/associations/eia-id Si un accélérateur Elastic Inference est attaché à l'instance, contient une chaîne JSON avec des informations sur l'accélérateur Elastic Inference, notamment son ID et son type. 2018-11-29
events/maintenance/history S'il y a des événements de maintenance terminés ou annulés pour l'instance, contient une chaîne JSON avec des informations sur ces événements. Pour plus d'informations, consultez Pour afficher l'historique des événements terminés ou annulés. 2018-08-17
events/maintenance/scheduled S'il y a des événements de maintenance activés pour l'instance, contient une chaîne JSON avec des informations sur ces événements. Pour plus d'informations, consultez Afficher les événements planifiés. 2018-08-17
events/recommendations/rebalance Heure approximative, UTC, à laquelle la notification de recommandation de rééquilibrage d'instance EC2 est émise pour l'instance. Voici un exemple de métadonnées pour cette catégorie : {"noticeTime": "2020-11-05T08:22:00Z"}. Cette catégorie n'est disponible qu'après l'émission de la notification. Pour plus d'informations, consultez Recommandations de rééquilibrage des instances EC2. 27-10-2020
hostname Si l'instance EC2 utilise l'appellation basée sur l'adresse IP (IPBN), il s'agit du nom d'hôte DNS IPv4 privé de l'instance. Si l'instance EC2 utilise l'appellation basée sur les ressources (RBN), il s'agit du RBN. Dans le cas où plusieurs interfaces réseau sont présentes, cela fait référence au périphérique eth0 (le périphérique dont le numéro de périphérique est 0). Pour plus d'informations sur IPBN et RBN, consultez Types de noms d'hôtes des instances Amazon EC2. 1.0
iam/info Si un rôle IAM est associé à l'instance, il contient des informations concernant la dernière mise à jour du profil d'instance, parmi lesquelles la date de dernière mise à jour (LastUpdated), l'InstanceProfileArn et l'InstanceProfileId de l'instance. Sinon, absent. 2012-01-12
iam/security-credentials/role-name Si un rôle IAM est associé à l'instance, nom-rôle est le nom du rôle et nom-rôle contient les informations d'identification de sécurité temporaires associées au rôle (pour plus d'informations, consultez Extraire les informations d'identification de sécurité à partir des métadonnées d'instance). Sinon, absent. 2012-01-12
identity-credentials/ec2/info [Usage interne uniquement] Informations sur les informations d'identification dans identity-credentials/ec2/security-credentials/ec2-instance. Ces informations d'identification sont utilisées par des fonctions AWS telles que EC2 Instance Connect et ne disposent pas d'autorisations ou de privilèges d'API AWS supplémentaires au-delà de l'identification de l'instance. 2018-05-23
identity-credentials/ec2/security-credentials/ec2-instance [Usage interne uniquement] Informations d'identification permettant au logiciel sur les instances de s'identifier auprès d'AWS pour prendre en charge des fonctions telles que EC2 Instance Connect. Ces informations d'identification ne disposent pas d'autorisations ou de privilèges d'API AWS supplémentaires. 2018-05-23
instance-action Informe l'instance qu'elle devrait redémarrer en vue de la création d'un bundle. Valeurs valides : none | shutdown | bundle-pending. 2008-09-01
instance-id L'ID de cette instance. 1.0
instance-life-cycle Option d'achat de cette instance. Pour plus d'informations, consultez Options d'achat d'instance. 01-10-2019
instance-type Le type d'instance. Pour plus d'informations, consultez Types d'instance. 2007-08-29
ipv6 L'adresse IPv6 de l'instance. Dans le cas où plusieurs interfaces réseau sont présentes, cela fait référence à l'interface réseau du périphérique eth0 (le périphérique dont le numéro de périphérique est 0) et à la première adresse IPv6 attribuée. Si aucune adresse IPv6 n'existe sur l'interface réseau [0], cet élément n'est pas défini et génère une réponse HTTP 404. 03-01-2021
kernel-id L'ID du noyau lancé avec l'instance, le cas échéant. 2008-02-01
local-hostname Dans le cas où plusieurs interfaces réseau sont présentes, cela fait référence au périphérique eth0 (le périphérique dont le numéro de périphérique est 0). Si l'instance EC2 utilise l'appellation basée sur l'adresse IP (IPBN), il s'agit du nom d'hôte DNS IPv4 privé de l'instance. Si l'instance EC2 utilise l'appellation basée sur les ressources (RBN), il s'agit du RBN. Pour plus d'informations sur IPBN, RBN et l'appellation des instances EC2, consultez Types de noms d'hôtes des instances Amazon EC2. 2007-01-19
local-ipv4 L'adresse IPv4 privée de l'instance. Dans le cas où plusieurs interfaces réseau sont présentes, cela fait référence au périphérique eth0 (le périphérique dont le numéro de périphérique est 0). S'il s'agit d'une instance IPv6 uniquement, cet élément n'est pas défini et génère une réponse HTTP 404. 1.0
mac L'adresse de contrôle d'accès média (MAC) de l'instance. Dans le cas où plusieurs interfaces réseau sont présentes, cela fait référence au périphérique eth0 (le périphérique dont le numéro de périphérique est 0). 2011-01-01
metrics/vhostmd Plus disponible. 2011-05-01
network/interfaces/macs/mac/device-number Le numéro de périphérique unique associé à cette interface. Le numéro de périphérique correspond au nom du périphérique, par exemple un device-number de 2 est pour le périphérique eth2. Cette catégorie correspond aux champs DeviceIndex et device-index utilisés par l'API Amazon EC2 et les commandes EC2 pour la AWS CLI. 2011-01-01
network/interfaces/macs/mac/interface-id L'ID de l'interface réseau. 2011-01-01
network/interfaces/macs/mac/ipv4-associations/public-ip Les adresses IPv4 privées qui sont associées à chaque adresse IP publique et assignées à cette interface. 2011-01-01
network/interfaces/macs/mac/ipv6s Les adresses IPv6 privées associées à l'interface. Retournés uniquement pour les instances lancées dans un VPC. 2016-06-30
network/interfaces/macs/mac/local-hostname

Le nom d'hôte DNS IPv4 privé de l'instance. Dans le cas où plusieurs interfaces réseau sont présentes, cela fait référence au périphérique eth0 (le périphérique dont le numéro de périphérique est 0). S'il s'agit d'une instance IPv6 uniquement, il s'agit du nom basé sur les ressources. Pour plus d'informations sur IPBN et RBN, consultez Types de noms d'hôtes des instances Amazon EC2.

2007-01-19
network/interfaces/macs/mac/local-ipv4s Les adresses IPv4 privées associées à l'interface. S'il s'agit d'une interface réseau IPv6 uniquement, cet élément n'est pas défini et génère une réponse HTTP 404. 2011-01-01
network/interfaces/macs/mac/mac L'adresse MAC de l'instance. 2011-01-01
network/interfaces/macs/mac/network-card-index L'index de la carte réseau. Certains types d'instance prennent en charge plusieurs cartes réseau. 2020-11-01
network/interfaces/macs/mac/owner-id L'ID du propriétaire de l'interface réseau. Dans les environnements à interfaces multiples, une interface peut être attachée à un tiers, par exemple Elastic Load Balancing. Le trafic sur l'interface est toujours facturé au propriétaire de l'interface. 2011-01-01
network/interfaces/macs/mac/public-hostname Le DNS public de l'interface (IPv4). Cette catégorie n'est retournée que si l'attribut enableDnsHostnames est défini comme true. Pour plus d'informations, consultez Utilisation de DNS avec votre VPC dans le Amazon VPC Guide de l'utilisateur. Si l'instance ne possède qu'une adresse IPv6 publique et aucune adresse IPv4 publique, cet élément n'est pas défini et génère une réponse HTTP 404. 2011-01-01
network/interfaces/macs/mac/public-ipv4s L'adresse IP publique ou les adresses IP Elastic associées à l'interface. Il peut y avoir plusieurs adresses IPv4 sur une instance. 2011-01-01
network/interfaces/macs/mac/security-groups Les groupes de sécurité auxquels l'interface réseau appartient. 2011-01-01
network/interfaces/macs/mac/security-group-ids Les ID des groupes de sécurité auxquels l'interface réseau appartient. 2011-01-01
network/interfaces/macs/mac/subnet-id L'ID du sous-réseau (subnet) dans lequel l'interface réside. 2011-01-01
network/interfaces/macs/mac/subnet-ipv4-cidr-block Le bloc d'adresse CIDR IPv4 du sous-réseau dans lequel l'interface réside. 2011-01-01
network/interfaces/macs/mac/subnet-ipv6-cidr-blocks Le bloc d'adresse CIDR IPv6 du sous-réseau dans lequel l'interface réside. 2016-06-30
network/interfaces/macs/mac/vpc-id L'ID du VPC dans lequel l'interface réside. 2011-01-01
network/interfaces/macs/mac/vpc-ipv4-cidr-block Le bloc d'adresse CIDR IPv4 principal pour le VPC. 2011-01-01
network/interfaces/macs/mac/vpc-ipv4-cidr-blocks Les blocs d'adresse CIDR IPv4 pour le VPC. 2016-06-30
network/interfaces/macs/mac/vpc-ipv6-cidr-blocks Le bloc d'adresse CIDR IPv6 du VPC dans lequel l'interface réside. 2016-06-30
placement/availability-zone La zone de disponibilité dans laquelle l'instance a été lancée. 2008-02-01
placement/availability-zone-id ID de zone de disponibilité statique dans laquelle l'instance est lancée. L'ID de zone de disponibilité est cohérent entre les comptes. Toutefois, il peut être différent de la zone de disponibilité, qui peut varier selon le compte. 01-10-2019
placement/group-name Nom du groupe de placement dans lequel l'instance est lancée. 2020-08-24
placement/host-id ID de l'hôte sur lequel l'instance est lancée. Applicable uniquement aux Hôtes dédiés. 2020-08-24
placement/partition-number Numéro de la partition dans laquelle l'instance est lancée. 2020-08-24
placement/region Région AWS dans laquelle l'instance est lancée. 2020-08-24
product-codes Codes produit AWS Marketplace associés à l'instance, le cas échéant. 2007-03-01
public-hostname Le DNS public de l'instance (IPv4). Cette catégorie n'est retournée que si l'attribut enableDnsHostnames est défini comme true. Pour plus d'informations, consultez Utilisation de DNS avec votre VPC dans le Amazon VPC Guide de l'utilisateur. Si l'instance ne possède qu'une adresse IPv6 publique et aucune adresse IPv4 publique, cet élément n'est pas défini et génère une réponse HTTP 404. 2007-01-19
public-ipv4 L'adresse IPv4 publique. Si une adresse IP Elastic est associée à l'instance, la valeur retournée est l'adresse IP Elastic. 2007-01-19
public-keys/0/openssh-key Clé publique. Disponible uniquement si fournie au moment du lancement de l'instance. 1.0
ramdisk-id L'ID du disque RAM spécifié au moment du lancement, le cas échéant. 2007-10-10
reservation-id L'ID de la réservation. 1.0
security-groups

Les noms des groupes de sécurité appliqués à l'instance.

Après le lancement, vous pouvez modifier les groupes de sécurité des instances. De tels changements apparaissent ici et dans réseau/interfaces/macs/mac/groupes-sécurité.

1.0
services/domain

Le domaine des ressources AWS de la région.

2014-02-25
services/partition

Partition dans laquelle se trouve la ressource. Pour les Régions AWS standards, la partition est aws. Si vous avez des ressources dans d'autres partitions, la partition est aws-partitionname. Par exemple, la partition des ressources de la région Chine (Beijing) est aws-cn.

2015-10-20
spot/instance-action

L'action (hibernation, arrêt ou résiliation) et l'heure approximative (UTC) à laquelle l'action aura lieu. Cet élément est présent uniquement si l'instance Spot a été balisée pour être mise en veille prolongée, arrêtée ou résiliée. Pour plus d'informations, consultez instance-action.

2016-11-15
spot/termination-time

L'heure approximative (indiquée au format UTC) à laquelle le système d'exploitation de votre instance Spot recevra le signal d'arrêt. Cet élément n'est présent et ne contient une valeur temporelle (par exemple, 2015-01-05T18:02:00Z) que si l'instance Spot a été balisée en vue de son arrêt par Amazon EC2. L'élément heure-arrêt n'est pas défini à une heure précise si vous avez mis fin vous-même à l'instance Spot. Pour plus d'informations, consultez termination-time.

2014-11-05
tags/instance Identifications associées à l'instance. Disponible uniquement si vous autorisez explicitement l'accès aux identifications dans les métadonnées d'instance. Pour plus d'informations, consultez Autoriser l'accès aux identifications dans les métadonnées d'instance. 23-03-2021

Catégories de données dynamiques

Le tableau ci-après répertorie les catégories de données dynamiques.

Catégorie Description Version lors de la publication de la catégorie
fws/instance-monitoring Valeur indiquant si le client a activé la surveillance détaillée toutes les minutes dans CloudWatch. Valeurs valides : enabled | disabled 2009-04-04
instance-identity/document JSON contenant les attributs d'instance, tels que l'ID d'instance, l'adresse IP privée, etc. Voir Documents d'identité d'instance. 2009-04-04
instance-identity/pkcs7 Utilisé pour vérifier l'authenticité et le contenu du document par rapport à la signature. Voir Documents d'identité d'instance. 2009-04-04
instance-identity/signature Les données pouvant être utilisées par d'autres pour vérifier leur origine et leur authenticité. Voir Documents d'identité d'instance. 2009-04-04