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 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 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 d'un parc EC2, cette valeur est toujours égale à 0. |
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 : |
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/ |
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/ |
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 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/
|
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 |
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 que EC2 Instance Connect et la configuration de gestion d'hôte AWS Systems Manager par défaut. Ces informations d'identification ne sont associées à aucune politique, elles ne disposent donc d'aucune autorisation d' AWS API supplémentaire autre que l'identification de l'instance par rapport à la AWS fonctionnalité. Pour plus d’informations, consultez Rôles d’identité d’instance. | 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'instances Amazon EC2. | 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/
|
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/
|
L’ID de l’interface réseau. | 2011-01-01 |
network/interfaces/macs/
|
Les adresses IPv4 privées qui sont associées à chaque adresse IP publique et assignées à cette interface. | 2011-01-01 |
network/interfaces/macs/ |
Les adresses IPv6 attribuées à l'interface. | 2016-06-30 |
network/interfaces/macs/ |
Le préfixe IPv6 attribué à l'interface réseau. | |
network/interfaces/macs/
|
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/
|
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/
|
L’adresse MAC de l’instance. | 2011-01-01 |
network/interfaces/macs/
|
L’index de la carte réseau. Certains types d’instance prennent en charge plusieurs cartes réseau. | 2020-11-01 |
network/interfaces/macs/
|
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/
|
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 DNS attributes for your VPC (Attributs DNS pour votre VPC) dans le Guide de l’utilisateur d’Amazon VPC. 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/
|
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/
|
Les groupes de sécurité auxquels l’interface réseau appartient. | 2011-01-01 |
network/interfaces/macs/
|
Les ID des groupes de sécurité auxquels l’interface réseau appartient. | 2011-01-01 |
network/interfaces/macs/
|
L’ID du sous-réseau (subnet) dans lequel l’interface réside. | 2011-01-01 |
network/interfaces/macs/
|
Le bloc d’adresse CIDR IPv4 du sous-réseau dans lequel l’interface réside. | 2011-01-01 |
network/interfaces/macs/
|
Le bloc d’adresse CIDR IPv6 du sous-réseau dans lequel l’interface réside. | 2016-06-30 |
network/interfaces/macs/
|
L’ID du VPC dans lequel l’interface réside. | 2011-01-01 |
network/interfaces/macs/ |
Le bloc d’adresse CIDR IPv4 principal pour le VPC. | 2011-01-01 |
network/interfaces/macs/ |
Les blocs d’adresse CIDR IPv4 pour le VPC. | 2016-06-30 |
network/interfaces/macs/ |
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
|
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
|
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 DNS attributes for your VPC (Attributs DNS pour votre VPC) dans le Guide de l’utilisateur d’Amazon VPC. 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/ |
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 est |
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é le suivi détaillé d'une minute 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. veuillez consulter 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. veuillez consulter 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é. veuillez consulter Documents d’identité d’instance. | 2009-04-04 |
