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 incluent les éléments suivants :
- Propriétés des métadonnées de l'instance
-
Les propriétés des métadonnées de l'instance sont divisées en catégories, par exemple le nom d'hôte, les événements et les 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 qu'un document d'identité d'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 de l'instance pour accéder aux données utilisateur que vous avez spécifiées lors 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 gérez des serveurs Web pour différentes petites entreprises, elles peuvent toutes utiliser le même générique AMI et récupérer leur contenu à partir d'un compartiment Amazon S3 que vous spécifiez dans les données utilisateur au lancement. Pour ajouter un nouveau client à tout moment, créez un compartiment pour le client, ajoutez son contenu et lancez-le AMI avec le nom de compartiment unique fourni dans votre code dans les données utilisateur. Si vous lancez plusieurs instances à l'aide du même
RunInstancesappel, les données utilisateur sont disponibles pour toutes les instances de cette réservation. Chaque instance faisant partie de la même réservation possède unami-launch-indexnuméro unique, ce qui vous permet d'écrire du code qui contrôle ce que font les instances. Par exemple, le premier hôte peut s’élire comme nœud d’origine dans un cluster. Pour un exemple de AMI lancement détaillé, voirIdentifiez 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
- Catégories de données dynamiques
- Accéder aux métadonnées d'une EC2 instance
- Configuration des options du service de métadonnées d'instance
- Exécuter des commandes lorsque vous lancez une EC2 instance avec saisie de données utilisateur
- Identifiez chaque instance lancée en une seule demande
Catégories de métadonnées d’instance
Les propriétés des métadonnées de l'instance sont divisées en catégories. Pour récupérer les propriétés des métadonnées de l'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 : |
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/ |
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/ |
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/
|
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é de l'instance qui permettent au logiciel sur instance de s'identifier pour AWS pour prendre en charge des fonctionnalités telles qu'EC2Instance Connect et AWS Systems Manager Configuration de gestion d'hôte par défaut. Ces informations d'identification ne sont associées à aucune politique, elles n'ont donc aucune politique supplémentaire AWS APIautorisations autres que l'identification de l'instance auprès du AWS fonction. 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/
|
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 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 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/
|
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/
|
MACAdresse 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/
|
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/
|
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 IPv4 CIDR bloc du sous-réseau dans lequel réside l'interface. | 2011-01-01 |
network/interfaces/macs/
|
Le IPv6 CIDR bloc du sous-réseau dans lequel réside l'interface. | 2016-06-30 |
network/interfaces/macs/
|
L'ID VPC dans lequel réside l'interface. | 2011-01-01 |
network/interfaces/macs/ |
Le IPv4 CIDR bloc principal duVPC. | 2011-01-01 |
network/interfaces/macs/ |
Les IPv4 CIDR blocs pour leVPC. | 2016-06-30 |
network/interfaces/macs/ |
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
|
Le 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/ |
1.0 |
services/domain
|
Le domaine pour AWS ressources pour la région. |
2014-02-25 |
services/partition
|
Partition dans laquelle se trouve la ressource. Pour le standard AWS Régions, c'est la partition |
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 |
