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.
Utiliser les métadonnées des instances pour gérer votre instance EC2
Les métadonnées d’instance sont des données portant sur votre instance que vous pouvez utiliser pour configurer ou gérer l’instance en cours d’exécution. Les métadonnées de l’instance comprennent les éléments suivants :
- Propriétés des métadonnées de l’instance
-
Les métadonnées de l’instance sont divisées en catégories, par exemple, nom d’hôte, événements et groupes de sécurité.
- Données dynamiques
-
Les données dynamiques sont des métadonnées générées lors du lancement de l’instance, telles que le document d’identité de l’instance. Pour de plus amples informations, veuillez consulter Catégories de données dynamiques.
- Données de l’utilisateur
-
Vous pouvez également utiliser les métadonnées d’instance pour accéder aux données utilisateur que vous avez spécifiées au moment du lancement de votre instance. Par exemple, vous pouvez spécifier des paramètres pour la configuration de votre instance ou inclure un script simple. Vous pouvez créer des AMI génériques et utiliser des données utilisateur pour modifier les fichiers de configuration fournis au moment du lancement. Par exemple, si vous exécutez des serveurs web pour plusieurs petites entreprises, ces serveurs peuvent tous utiliser la même AMI générique et récupérer leur contenu à partir du compartiment Amazon S3 que vous spécifiez dans les données utilisateur lors du lancement. Pour ajouter un nouveau client à n’importe quel moment, créez un compartiment pour le client, ajoutez son contenu, puis lancez votre AMI avec l’unique nom de compartiment fourni à votre code dans les données utilisateur. Si vous lancez plusieurs instances à l’aide du même appel
RunInstances, les données utilisateur sont disponibles pour toutes les instances de cette réserve. Chaque instance faisant partie de la même réservation possède un numéro uniqueami-launch-index, ce qui vous permet d’écrire un code qui contrôle les opérations effectuées par les instances. Par exemple, le premier hôte peut s’élire comme nœud d’origine dans un cluster. Pour obtenir un exemple détaillé sur le lancement d’une AMI, consultez Identifiez chaque instance lancée en une seule demande.
Important
Bien que les métadonnées d’instance et les données utilisateur ne soient accessibles qu’au sein de l’instance elle-même, elles ne sont pas protégées par des méthodes d’authentification ou de chiffrement. Toute personne ayant un accès direct à l’instance, et potentiellement tout logiciel s’exécutant sur l’instance, peut afficher ses métadonnées. Vous ne devez donc pas stocker de données sensibles, telles que des mots de passe ou des clés de chiffrement à longue durée, ou des données utilisateur.
Table des matières
Catégories de métadonnées d’instance
Les propriétés des métadonnées d’instance sont divisées en catégories. Pour récupérer les propriétés des 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 Nitro-based les instances, vous pouvez récupérer les métadonnées des instances uniquement 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 appel RunInstances, 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 EBS-backed AMI Amazon pour lancer l'instance, le résultat renvoyé estunknown. |
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 root/boot fichiers. | 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 |
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. | 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 Affichez les événements programmées qui affectent vos instances Amazon EC2. | 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 de plus amples informations, veuillez consulter Recommandations de rééquilibrage des instances EC2. |
27/10/2020 |
hostname |
Si l'instance EC2 utilise la IP-based dénomination (IPBN), il s'agit du nom d'hôte DNS IPv4 privé de l'instance. Si l'instance EC2 utilise la Resource-based dénomination (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 Noms d’hôte et domaines des instances EC2. | 1.0 |
iam/info
|
Si un rôle IAM est associé à l'instance, il contient des informations sur la dernière fois que le profil d'instance a été mis à jour, 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, il role-name s'agit du 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, consultezExtraire 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 pour prendre AWS en charge des fonctionnalités telles que EC2 Instance Connect et la configuration de gestion des hôtes AWS Systems Manager par défaut. Aucune politique n'est associée à ces informations d'identification. Elles ne disposent donc d'aucune autorisation d' AWS API supplémentaire au-delà de l'identification de l'instance associée à la AWS fonctionnalité. Pour de plus amples informations, veuillez consulter Rôles d’identité d’instance pour les instances Amazon EC2. | 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 Modalités de facturation et d'achat de l'Amazon EC2. | 01-10-2019 |
instance-type
|
Le type d’instance. Pour plus d’informations, consultez Types d’instances Amazon EC. | 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 la IP-based dénomination (IPBN), il s'agit du nom d'hôte DNS IPv4 privé de l'instance. Si l'instance EC2 utilise la Resource-based dénomination (RBN), il s'agit du RBN. Pour plus d’informations sur IPBN, RBN et l’appellation des instances EC2, consultez Noms d’hôte et domaines des instances 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 IPv6-only instance, 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 associées à l’interface. | 2016-06-30 |
network/interfaces/macs/ |
Préfixes IPv6 assignés à l’interface réseau | |
network/interfaces/macs/
|
Le nom d'hôte DNS IPv4 privé de l'interface réseau. Cette valeur n'est pas définie pour les interfaces ne comportant aucune adresse IP, telles que les EFA-only interfaces. S'il s'agit d'une IPv6-only interface, il s'agit du nom basé sur les ressources. Pour plus d’informations sur IPBN et RBN, consultez Noms d’hôte et domaines des instances EC2. |
2007-01-19 |
network/interfaces/macs/
|
Les adresses IPv4 privées associées à l’interface. S'il s'agit d'une interface IPv6-only réseau, 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 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. Ces modifications sont reflétées ici et dans network/interfaces /macs/ /security-groups. |
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 est présent et contient une valeur temporelle (par exemple, 05/01/2015T18:02:00Z) 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 |
system |
Le type de virtualisation sous-jacent (hyperviseur) de l’instance. | 24/09/24 |
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 Activation de l’accès aux balises 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é une surveillance détaillée 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. Consultez Documents d’identité d’instance pour les instances Amazon EC2. | 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 instances Amazon EC2. | 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 instances Amazon EC2. | 2009-04-04 |
