Catégories de métadonnées d’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.

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 d'avoir à mettre à jour votre code chaque fois qu'Amazon EC2 publie une nouvelle version de métadonnées d'instance, utilisez latest plutôt le numéro de version dans vos demandes de métadonnées. Pour de plus amples informations, veuillez consulter Obtenir les versions disponibles des métadonnées d’instance.

Lorsqu'Amazon EC2 publie 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'MACadresse 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'AMIID utilisé pour lancer l'instance. 1.0
ami-launch-index Si vous lancez plusieurs instances à l'aide du même RunInstances appel, cette valeur indique l'ordre de lancement de chaque instance. La valeur 0 indique la première instance lancée. Si vous lancez des instances à l'aide d'Auto Scaling ou de EC2 fleet, cette valeur est toujours égale à 0. 1.0
ami-manifest-path Le chemin d'accès au fichier AMI manifeste dans Amazon S3. Si vous avez utilisé une instance EBS soutenue par Amazon AMI pour lancer l'instance, le résultat renvoyé estunknown. 1.0
ancestor-ami-ids Le AMI IDs de toutes les instances qui ont été regroupées pour créer cela. AMI Cette valeur n'existera que si le fichier AMI manifeste contient une ancestor-amis clé. 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 la section Récupérer l'état du cycle de vie cible via les métadonnées de l'instance dans le manuel Amazon EC2 Auto Scaling User Guide.

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 appareils virtuels associés à tous les EBS volumes Amazon. Les EBS volumes Amazon ne sont disponibles dans les métadonnées que s'ils étaient présents au moment du lancement ou lors du dernier démarrage de l'instance. Le N indique l'indice du EBS volume Amazon (tel que ebs1 ouebs2). 2007-12-15
block-device-mapping/ephemeralN Les périphériques virtuels pour tous les volumes de stockage NVMe autres que les instances. 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 est GPU attaché à l'instance, il contient une JSON chaîne contenant des informations sur l'ElasticGPU, notamment son identifiant et ses informations de connexion. 2016-11-30
elastic-inference/associations/eia-id Si un accélérateur Elastic Inference est attaché à l'instance, il contient une JSON chaîne contenant des informations sur l'accélérateur Elastic Inference, notamment son ID et son type. 2018-11-29
events/maintenance/history Si des événements de maintenance sont terminés ou annulés pour l'instance, contient une JSON chaîne contenant des informations sur les événements. 2018-08-17
events/maintenance/scheduled S'il existe des événements de maintenance actifs pour l'instance, contient une JSON chaîne contenant des informations sur ces événements. Pour de plus amples informations, veuillez consulter Afficher les événements planifiés qui affectent vos EC2 instances Amazon. 2018-08-17
events/recommendations/rebalance Heure approximative, enUTC, à laquelle la notification de recommandation de rééquilibrage d'EC2instance 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 de plus amples informations, veuillez consulter EC2recommandations de rééquilibrage des instances. 27/10/2020
hostname Si l'EC2instance utilise un nommage basé sur l'adresse IP (IPBN), il s'agit du IPv4 DNS nom d'hôte privé de l'instance. Si l'EC2instance utilise le nommage basé 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 etRBN, voirTypes de noms EC2 d'hôte des instances Amazon. 1.0
iam/info Si un IAM rôle est associé à l'instance, contient des informations sur la dernière mise à jour du profil de l'instance, y compris la LastUpdated date de l'instance InstanceProfileArn, etInstanceProfileId. Sinon, absent. 2012-01-12
iam/security-credentials/role-name Si un IAM rôle est associé à l'instance, role-name est le nom du rôle, et role-name contient les informations d'identification de sécurité temporaires associées au rôle (pour plus d'informations, voirExtraire les informations d’identification de sécurité à partir des métadonnées d’instance). Sinon, absent. 2012-01-12
identity-credentials/ec2/info Informations sur les informations d’identification dans identity-credentials/ec2/security-credentials/ec2-instance. 2018-05-23
identity-credentials/ec2/security-credentials/ec2-instance Informations d'identification pour le rôle d'identité d'instance qui permettent au logiciel sur instance de s'identifier afin de AWS prendre en charge des fonctionnalités telles qu'EC2Instance Connect et la configuration de gestion d'hôte AWS Systems Manager par défaut. Aucune politique n'est attachée à ces informations d'identification. Elles ne disposent donc d'aucune AWS API autorisation supplémentaire au-delà de l'identification de l'instance par rapport à la AWS fonctionnalité. Pour de plus amples informations, veuillez consulter Rôles d'identité d'instance pour les EC2 instances Amazon. 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 EC2 de facturation et d'achat Amazon. 01-10-2019
instance-type Le type d’instance. Pour plus d’informations, consultez Types d'EC2instances Amazon. 2007-08-29
ipv6 IPv6Adresse de l'instance. Dans les 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 IPv6 adresse attribuée. Si aucune IPv6 adresse n'existe sur l'interface réseau [0], cet élément n'est pas défini et entraîne 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'EC2instance utilise un nommage basé sur l'adresse IP (IPBN), il s'agit du IPv4 DNS nom d'hôte privé de l'instance. Si l'EC2instance utilise le nommage basé sur les ressources (RBN), il s'agit du. RBN Pour plus d'informations sur IPBNRBN, et la dénomination des EC2 instances, consultezTypes de noms EC2 d'hôte des instances Amazon. 2007-01-19
local-ipv4 IPv4Adresse 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 entraîne une réponse HTTP 404. 1.0
mac Adresse de contrôle d'accès au 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 device-index champs DeviceIndex et utilisés par Amazon EC2 API et aux EC2 commandes pour le 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 IPv4 adresses privées associées à chaque adresse IP publique et attribuées à cette interface. 2011-01-01
network/interfaces/macs/mac/ipv6s Les IPv6 adresses attribuées à l'interface. 2016-06-30
network/interfaces/macs/mac/ipv6-prefix Le IPv6 préfixe attribué à l'interface réseau.
network/interfaces/macs/mac/local-hostname

Le IPv4 DNS nom d'hôte 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 etRBN, voirTypes de noms EC2 d'hôte des instances Amazon.

2007-01-19
network/interfaces/macs/mac/local-ipv4s Les IPv4 adresses 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 entraîne une réponse HTTP 404. 2011-01-01
network/interfaces/macs/mac/mac MACAdresse de l'instance. 2011-01-01
network/interfaces/macs/mac/network-card 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 L'interface est publique DNS (IPv4). Cette catégorie n’est retournée que si l’attribut enableDnsHostnames est défini comme true. Pour plus d'informations, consultez DNSles attributs correspondants VPC dans le guide de VPC l'utilisateur Amazon. Si l'instance possède uniquement une IPv6 adresse publique et aucune IPv4 adresse publique, cet élément n'est pas défini et entraîne 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. Une instance peut IPv4 comporter plusieurs adresses. 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 Groupe IDs de sécurité auquel appartient l'interface réseau. 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 IPv4 CIDR bloc du sous-réseau dans lequel réside l'interface. 2011-01-01
network/interfaces/macs/mac/subnet-ipv6-cidr-blocks Le IPv6 CIDR bloc du sous-réseau dans lequel réside l'interface. 2016-06-30
network/interfaces/macs/mac/vpc-id L'ID VPC dans lequel réside l'interface. 2011-01-01
network/interfaces/macs/mac/vpc-ipv4-cidr-block Le IPv4 CIDR bloc principal duVPC. 2011-01-01
network/interfaces/macs/mac/vpc-ipv4-cidr-blocks Les IPv4 CIDR blocs pour leVPC. 2016-06-30
network/interfaces/macs/mac/vpc-ipv6-cidr-blocks Le IPv6 CIDR bloc VPC dans lequel réside l'interface. 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 AWS Région dans laquelle l'instance est lancée. 2020-08-24
product-codes AWS Marketplace les codes de produit associés à l'instance, le cas échéant. 2007-03-01
public-hostname L'instance est publique DNS (IPv4). Cette catégorie n’est retournée que si l’attribut enableDnsHostnames est défini comme true. Pour plus d'informations, consultez DNSles attributs correspondants VPC dans le guide de VPC l'utilisateur Amazon. Si l'instance possède uniquement une IPv6 adresse publique et aucune IPv4 adresse publique, cet élément n'est pas défini et entraîne une réponse HTTP 404. 2007-01-19
public-ipv4 L'IPv4adresse 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 ID du RAM disque 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. Ces changements se reflètent ici et dans réseau/interfaces/macs/ mac/groupes de sécurité.

1.0
services/domain

Le domaine des AWS ressources pour la région.

2014-02-25
services/partition

Partition dans laquelle se trouve la ressource. Pour les AWS régions standard, la partition estaws. 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 fin) et l'heure approximative à laquelle UTC 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

Heure approximative, enUTC, pendant laquelle le système d'exploitation de votre instance Spot recevra le signal d'arrêt. Cet article est présent et contient une valeur temporelle (par exemple, 2015-01-05T 18:02:00 Z) uniquement si l'instance Spot a été marquée pour résiliation 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é le suivi détaillé d'une minute dans CloudWatch. Valeurs valides : enabled | disabled 2009-04-04
instance-identity/document JSONcontenant des attributs d'instance, tels que l'identifiant d'instance, l'adresse IP privée, etc. Consultez Documents d'identité d'instance pour les EC2 instances Amazon. 2009-04-04
instance-identity/pkcs7 Utilisé pour vérifier l’authenticité et le contenu du document par rapport à la signature. Consultez Documents d'identité d'instance pour les EC2 instances Amazon. 2009-04-04
instance-identity/signature Les données pouvant être utilisées par d’autres pour vérifier leur origine et leur authenticité. Consultez Documents d'identité d'instance pour les EC2 instances Amazon. 2009-04-04