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 de l'instance pour gérer votre EC2 instance
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 également créer des fichiers génériques AMIs et utiliser les 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 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 les instances basées sur Nitro, vous pouvez récupérer les métadonnées de l’instance uniquement pour les catégories disponibles au moment du 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 de EC2 fleet, 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
|
L'AMI IDs 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 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 |
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 Afficher les événements planifiés qui affectent vos EC2 instances Amazon. | 2018-08-17 |
events/recommendations/rebalance |
Heure approximative, en UTC, à laquelle la notification de recommandation de rééquilibrage d' EC2 instance 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 EC2 recommandations de rééquilibrage des instances. |
27/10/2020 |
hostname |
Si l' EC2 instance utilise la dénomination basée sur l'adresse IP (IPBN), il s'agit du nom d'hôte IPv4 DNS privé de l'instance. Si l' EC2 instance 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 et RBN, consultez Types de noms EC2 d'hôte des instances Amazon. | 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, role-name c'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'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 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' EC2 instances Amazon. | 2007-08-29 |
ipv6
|
IPv6 Adresse 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'EC2 instance utilise la dénomination basée sur l'adresse IP (IPBN), il s'agit du nom d'hôte IPv4 DNS privé de l'instance. Si l' EC2 instance utilise le nommage basé sur les ressources (RBN), il s'agit du RBN. Pour plus d'informations sur l'IPBN, le RBN et la dénomination des EC2 instances, consultez. Types de noms EC2 d'hôte des instances Amazon | 2007-01-19 |
local-ipv4
|
IPv4 Adresse 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
|
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 device-index champs DeviceIndex et utilisés par l' EC2 API Amazon et aux EC2 commandes pour le AWS CLI. |
2011-01-01 |
network/interfaces/macs/
|
L’ID de l’interface réseau. | 2011-01-01 |
network/interfaces/macs/
|
Les IPv4 adresses privées associées à chaque adresse IP publique et attribuées à cette interface. | 2011-01-01 |
network/interfaces/macs/ |
Les IPv6 adresses attribuées à l'interface. | 2016-06-30 |
network/interfaces/macs/ |
Le IPv6 préfixe attribué à l'interface réseau. | |
network/interfaces/macs/
|
Le nom d'hôte IPv4 DNS 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 EC2 d'hôte des instances Amazon. |
2007-01-19 |
network/interfaces/macs/
|
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/
|
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 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/
|
L’adresse IP publique ou les adresses IP Elastic associées à l’interface. Il peut y avoir plusieurs IPv4 adresses 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/
|
Groupe IDs de sécurité auquel appartient l'interface réseau. | 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 IPv4 CIDR du sous-réseau dans lequel réside l'interface. | 2011-01-01 |
network/interfaces/macs/
|
Le bloc IPv6 CIDR du sous-réseau dans lequel réside l'interface. | 2016-06-30 |
network/interfaces/macs/
|
L’ID du VPC dans lequel l’interface réside. | 2011-01-01 |
network/interfaces/macs/ |
Le bloc IPv4 CIDR principal du VPC. | 2011-01-01 |
network/interfaces/macs/ |
Les blocs IPv4 CIDR pour le VPC. | 2016-06-30 |
network/interfaces/macs/ |
Le bloc IPv6 CIDR du 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
|
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 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' IPv4 adresse 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 dansnetwork/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 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
|
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 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 |
