Valeurs de métadonnées de VM par défaut

Compute Engine définit un ensemble d'entrées de métadonnées par défaut qui fournissent des informations sur votre instance de machine virtuelle (VM) ou votre projet. Les métadonnées par défaut sont toujours définies et configurées par le serveur. Les clés de métadonnées par défaut sont sensibles à la casse.

Pour en savoir plus sur l'interrogation des valeurs de métadonnées, consultez la page Interroger les métadonnées de VM.

Organisation des valeurs de métadonnées

  • Métadonnées du projet et de l'instance : les métadonnées peuvent être attribuées à des projets et à des VM. Les métadonnées d'un projet se propagent sur toutes les VM de ce projet, tandis que les métadonnées d'une instance ne s'appliquent qu'à une seule VM.

  • Listes de répertoires : certaines entrées de métadonnées sont des répertoires contenant d'autres clés de métadonnées. Cette différence est indiquée à l'aide d'une barre oblique dans le nom des métadonnées. Par exemple, attributes/ est un répertoire qui contient d'autres clés de métadonnées.

Métadonnées du projet

Les entrées de métadonnées du projet sont stockées dans le répertoire suivant :

  • http://metadata.google.internal/computeMetadata/v1/project/
Entrée de métadonnées Description
attributes/

Répertoire des valeurs de métadonnées personnalisées transmises aux VM de votre projet lors du démarrage ou de l'arrêt. Ces valeurs personnalisées peuvent être des attributs Google Cloud ou des valeurs de métadonnées créées par l'utilisateur.

Pour obtenir la liste des attributs Google Cloud au niveau du projet que vous pouvez définir, consultez la section Attributs du projet.

Pour en savoir plus sur la définition des métadonnées, consultez la page Définir des métadonnées personnalisées.
numeric-project-id ID numérique du projet (numéro du projet) de l'instance, à ne pas confondre avec le nom du projet visible dans la console Google Cloud. Cette valeur est différente de la valeur d'entrée de métadonnées project-id.
project-id ID du projet.

Attributs du projet

Les attributs du projet sont stockés dans le répertoire suivant :

  • http://metadata.google.internal/computeMetadata/v1/project/attributes/
Entrée de métadonnées Description
disable-legacy-endpoints

Désactive les anciens points de terminaison du serveur de métadonnées pour toutes les VM de votre projet.

Les anciens points de terminaison sont obsolètes, et toujours définis sur disable-legacy-endpoints=TRUE.

enable-guest-attributes

Définit les attributs d'invité pour le projet.

Les attributs d'invité sont des valeurs de métadonnées d'instances de VM personnalisées que vous pouvez utiliser pour publier des notifications d'état peu fréquentes, des données de faible volume ou des données de basse fréquence. Ces valeurs sont utiles pour indiquer la fin des scripts de démarrage ou pour fournir d’autres notifications d’état peu fréquentes à d’autres applications.

Pour en savoir plus sur les attributs d'invité, consultez la section Définir et interroger des attributs d'invité.

enable-os-inventory

Active ou désactive OS Inventory pour le projet.

Collecte et stocke les informations sur le système d'exploitation. Cela inclut des informations telles que le nom d'hôte, la version du noyau, l'architecture et les détails des packages installés.

Pour en savoir plus sur OS Inventory, consultez la page Afficher les détails des systèmes d'exploitation.

enable-oslogin

Active ou désactive la gestion des clés SSH dans votre projet.

Pour plus d'informations sur OS Login, consultez la page Configurer OS Login.

enable-windows-ssh

Active ou désactive SSH pour les VM Windows.

Pour en savoir plus, consultez la page Se connecter à des VM Windows à l'aide de SSH.

google-compute-default-region Si elle est définie, la région par défaut utilisée par le projet est enregistrée.

Pour en savoir plus sur la configuration des régions par défaut, consultez la section Région et zone par défaut.

google-compute-default-zone Si elle est définie, la zone par défaut utilisée par le projet est enregistrée.

Pour en savoir plus sur la configuration des zones par défaut, consultez la section Région et zone par défaut.

ssh-keys

Si vous gérez des clés SSH à l'aide de métadonnées, cet attribut vous permet de configurer des clés SSH publiques pouvant se connecter aux VM de ce projet. S'il existe plusieurs clés SSH, chaque clé est séparée par un caractère de retour à la ligne (\n). La valeur de l'attribut ssh-keys est une chaîne.

Exemple "user1:ssh-rsa mypublickey user1@host.com\nuser2:ssh-rsa mypublickey user2@host.com"

Les clés SSH gérées par OS Login ne sont pas visibles dans les métadonnées.

sshKeys Obsolète : utilisez ssh-keys.
vmdnssetting

Active le DNS zonal et le DNS global pour les VM de votre projet.

Pour en savoir plus sur les noms DNS internes, consultez la page DNS interne.

Métadonnées d'instances de VM

Les entrées de métadonnées de la VM sont stockées dans le répertoire suivant :

  • http://metadata.google.internal/computeMetadata/v1/instance/
Entrée de métadonnées Description
attributes/

Répertoire des valeurs de métadonnées personnalisées transmises à la VM lors du démarrage ou de l'arrêt. Ces valeurs personnalisées peuvent être des attributs Google Cloud ou des valeurs de métadonnées créées par l'utilisateur.

Pour obtenir la liste des attributs Google Cloud au niveau de l'instance que vous pouvez définir, consultez la section Attributs de l'instance.

Pour en savoir plus sur la définition des métadonnées personnalisées, consultez la section Définir des métadonnées personnalisées.
cpu-platform

Plate-forme de processeur de la VM.

Pour en savoir plus sur les plates-formes de processeur, consultez la page Plates-formes de processeur.
description Description en texte libre d'une instance attribuée avec l'option --description à l'aide de Google Cloud CLI ou de l'API.
disks/

Répertoire des disques associés à la VM. Les informations suivantes sont disponibles pour chaque disque :

  • device-name
  • index
  • interface
  • mode
  • type

Pour en savoir plus sur les disques, consultez la page Options de stockage.

guest-attributes/

Définit les attributs d'invité de la VM. Ces valeurs personnalisées peuvent être des attributs Google Cloud ou des valeurs de métadonnées créées par l'utilisateur.

Pour obtenir la liste des attributs Google Cloud au niveau de l'instance que vous pouvez définir, consultez la section Attributs d'invité de l'instance.

Pour en savoir plus sur les attributs d'invité, consultez la section Définir et interroger des attributs d'invité.

hostname Nom d'hôte de la VM.
id ID de la VM. Il s'agit d'un identifiant numérique unique généré par Compute Engine. Cette valeur est utile pour identifier les VM si vous n'utilisez pas de noms de VM.
image Image du système d'exploitation utilisée par la VM. Cette valeur a le format suivant : projects/IMAGE_PROJECT/global/images/IMAGE_NAME.
legacy-endpoint-access/ Stocke la liste des anciens points de terminaison. Les valeurs sont 0.1 et v1beta1.
licenses/ Liste des ID de codes de licence utilisés pour associer les licences aux images, instantanés et disques.
machine-type Type de machine de cette VM. Cette valeur a le format suivant : projects/PROJECT_NUM/machineTypes/MACHINE_TYPE
maintenance-event Indique si un événement de maintenance affecte cette VM. Pour en savoir plus, consultez la section Migrer à chaud.
name Nom de la VM.
network-interfaces/

Répertoire des interfaces réseau. Les informations suivantes sont disponibles pour chaque interface réseau :

  • access-configs/

    • external-ip
    • type
  • dns-servers
  • forwarded-ips/
  • gateway
  • ip
  • ip-aliases/
  • mac
  • mtu
  • network
  • subnetmask
  • target-instance-ips

Pour en savoir plus sur les interfaces réseau, consultez la page Présentation des configurations utilisant plusieurs interfaces réseau.

preempted

Valeur booléenne indiquant si une VM est sur le point d'être préemptée.
scheduling/

Définit les options de programmation de la VM.

La planification des valeurs de métadonnées inclut ce qui suit :

  • on-host-maintenance : indique si la VM s'arrête ou migre à chaud pendant la maintenance de l'hôte.
  • automatic-restart : si cette valeur est définie sur TRUE, la VM redémarre automatiquement après un événement de maintenance ou un plantage.
  • preemptible : si cette valeur est définie sur TRUE, l'instance est préemptive. Cette valeur est définie lorsque vous créez une VM, et elle ne peut pas être modifiée.

Pour en savoir plus sur les options de planification, consultez la page Définir les règles de disponibilité d'une instance.

service-accounts/

Répertoire des comptes de service associés à la VM. Pour chaque compte de service, les informations suivantes sont disponibles :

  • aliases
  • email : adresse e-mail associée au compte de service.
  • identity : jeton Web JSON unique à la VM. Vous devez inclure le paramètre audience dans votre requête pour cette valeur de métadonnées de VM. Par exemple, ?audience=http://www.example.com.

    Pour savoir comment demander et valider des jetons d'identité d'instance, consultez la page Vérifier l'identité des VM.

  • scopes : niveaux d'accès attribués au compte de service.
  • token : jeton d'accès OAuth2 pouvant être utilisé pour authentifier des applications.

    Pour en savoir plus sur les jetons d'accès, consultez la section Authentifier des applications directement avec les jetons d'accès.

Pour plus d'informations sur l'utilisation des comptes de service dans Compute Engine, consultez la page Comptes de service.

tags

Répertorie tous les tags réseau associés à la VM.

Pour en savoir plus sur les tags réseau, consultez la page Ajouter des tags réseau.

zone Zone où se trouve la VM. Cette valeur a le format suivant : projects/PROJECT_NUM/zones/ZONE.

Attributs des instances

Les attributs d'instance sont stockés dans le répertoire suivant :

  • http://metadata.google.internal/computeMetadata/v1/instance/attributes/
Entrée de métadonnées Description
physical_host

Chaîne de hachage qui représente l'emplacement d'une VM créée avec une stratégie d'emplacement compact.

Pour en savoir plus sur cet attribut, consultez la section Vérifier l'emplacement physique d'une VM.

enable-oslogin

Active ou désactive la gestion des clés SSH sur votre VM.

Pour plus d'informations sur OS Login, consultez la page Configurer OS Login.

enable-windows-ssh

Active ou désactive SSH pour les VM Windows.

Pour en savoir plus, consultez la page Se connecter à des VM Windows à l'aide de SSH.

vmdnssetting

Active le DNS zonal et le DNS global pour la VM.

Pour en savoir plus sur les noms DNS internes, consultez la page DNS interne.

ssh-keys

Si vous gérez des clés SSH à l'aide de métadonnées, cet attribut vous permet de configurer des clés SSH publiques pouvant se connecter aux VM de ce projet. S'il existe plusieurs clés SSH, chaque clé est séparée par un caractère de retour à la ligne (\n). La valeur de l'attribut ssh-keys est une chaîne.

Exemple "user1:ssh-rsa mypublickey user1@host.com\nuser2:ssh-rsa mypublickey user2@host.com"

Les clés SSH gérées par OS Login ne sont pas visibles dans les métadonnées.

Attributs d'invité de l'instance

Les attributs d'invité de l'instance sont stockés dans le répertoire suivant :

  • http://metadata.google.internal/computeMetadata/v1/instance/guest-attributes
Entrée de métadonnées Description
guestInventory/

Stocke OS Inventory pour la VM.

Collecte et stocke les informations sur le système d'exploitation. Cela inclut des informations telles que le nom d'hôte, la version du noyau, l'architecture et les détails des packages installés.

Pour en savoir plus sur OS Inventory, consultez la page Afficher les détails des systèmes d'exploitation.

hostkeys/

Stocke les clés d'hôte SSH. Les clés d'hôte peuvent servir à identifier un hôte ou une machine spécifique.

Pour plus d'informations sur les clés d'hôte, consultez la section Stocker les clés d'hôte en activant les attributs d'invité.

Étapes suivantes