Vordefinierte Metadatenschlüssel

Vordefinierte Metadatenschlüssel und ihre Werte enthalten Instanz- und Projektinformationen. Mit diesen Schlüsseln können Sie verschiedene Instanzverhaltensweisen steuern.

Wenn Sie eine neue Compute-Instanz erstellen, erstellt Compute Engine diese Schlüssel automatisch für Ihre Instanz auf dem Metadatenserver. Compute Engine füllt auch automatisch Werte für einige vordefinierte Schlüssel aus, z. B. die Instanz-ID oder die Projekt-ID. Bei anderen Schlüsseln legen Sie Werte fest, um Funktionen zu aktivieren oder zu deaktivieren. Wenn Sie beispielsweise OS Login für eine Instanz aktivieren möchten, setzen Sie den Schlüssel enable-oslogin auf TRUE.

Sie können die Werte dieser vordefinierten Schlüssel aktualisieren. Bei Schlüsselwerten wird zwischen Groß- und Kleinschreibung unterschieden. Sie können die Schlüssel jedoch nicht ändern. Wenn Sie die Metadatenschlüssel in Ihren Metadatenverzeichnissen instance/ und project/ kennen, können Sie die Instanzleistung optimieren, Konfigurationen beheben und eine zuverlässige Rechenumgebung aufrechterhalten.

Informationen zum Definieren, Kategorisieren und Sortieren von VM-Metadaten für Compute Engine finden Sie unter Informationen zu VM-Metadaten.

Vordefinierte Projekt-Metadatenschlüssel

Vordefinierte Metadatenschlüssel für Projektmetadaten werden im folgenden Verzeichnis gespeichert:

  • http://metadata.google.internal/computeMetadata/v1/project/

Die folgende Tabelle enthält eine Liste der Metadatenschlüssel und -verzeichnisse, die Compute Engine automatisch im Metadatenverzeichnis project/ erstellt:

Metadateneintrag Beschreibung
attributes/

Ein Verzeichnis mit benutzerdefinierten Metadatenwerten, die beim Starten oder Herunterfahren an die VMs in Ihrem Projekt übergeben werden. Diese benutzerdefinierten Werte können entweder Cloud de Confiance by S3NS Attribute oder von Nutzern erstellte Metadatenwerte sein.

Eine Liste der Cloud de Confiance by S3NS Attribute auf Projektebene, die Sie festlegen können, finden Sie unter Projektattribute.

Weitere Informationen zum Festlegen von Metadaten finden Sie unter Benutzerdefinierte Metadaten festlegen.
numeric-project-id Die numerische Projekt-ID (Projektnummer) der Instanz. Diese unterscheidet sich vom Projektnamen, der in der Cloud de Confiance consoleangezeigt wird. Dieser Wert unterscheidet sich vom project-id-Wert des Metadateneintrags.
project-id Die Projekt-ID.

Vordefinierte Projektattribut-Metadatenschlüssel

Vordefinierte Metadatenschlüssel für Projektattribute sind im folgenden Verzeichnis gespeichert:

  • http://metadata.google.internal/computeMetadata/v1/project/attributes/

Die folgende Tabelle enthält eine Liste der Metadatenschlüssel, die Compute Engine im Metadatenverzeichnis project/attributes/ erstellt, wenn sie für Ihr Projekt festgelegt sind, sowie die zugehörige Wirkung:

Metadateneintrag Beschreibung
disable-legacy-endpoints

Deaktiviert Legacy-Metadatenserver-Endpunkte für alle Instanzen in Ihrem Projekt.

Legacy-Endpunkte wurden verworfen, legt immer disable-legacy-endpoints=TRUE fest.

enable-guest-attributes

Legt Gastattribute für das Projekt fest.

Gastattribute sind benutzerdefinierte Metadatenwerte für VM-Instanzen, mit denen Sie unregelmäßige Statusbenachrichtigungen, kleinere Datenmengen oder selten verwendete Daten veröffentlichen können. Diese Werte sind nützlich, um das Ende von Startskripts anzuzeigen oder sonstige unregelmäßige Statusbenachrichtigungen an andere Anwendungen zu übergeben.

Weitere Informationen zu Gastattributen finden Sie unter Gastattribute festlegen und abfragen.

enable-os-inventory

Aktiviert oder deaktiviert OS Inventory für das Projekt.

Erfasst und speichert Betriebssysteminformationen. Dazu gehören Informationen wie Hostname, Kernel-Version, Architektur und installierte Pakete.

Weitere Informationen zu OS Inventory finden Sie unter Betriebssystemdetails ansehen.

enable-windows-ssh

Aktiviert oder deaktiviert SSH für Windows-VMs.

Weitere Informationen finden Sie unter Verbindung zu Windows-VMs über SSH herstellen.

google-compute-default-data-protection

Wenn dieses Flag festgelegt ist, wird die Standardoption gespeichert, die zum Sichern neuer Instanzen verwendet wird, die im Projekt erstellt wurden.

Weitere Informationen finden Sie unter Standardeinstellung für Back-ups für die Console konfigurieren.
google-compute-default-region Wenn dieses Flag festgelegt ist, wird die vom Projekt verwendete Standardregion gespeichert.

Weitere Informationen zum Festlegen von Standardregionen finden Sie unter Standardregion und -zone.

google-compute-default-zone Wenn dieses Flag festgelegt ist, wird die vom Projekt verwendete Standardzone gespeichert.

Weitere Informationen zum Festlegen von Standardzonen finden Sie unter Standardregion und -zone.

ssh-keys

Wenn Sie SSH-Schlüssel mithilfe von Metadaten verwalten, können Sie mit diesem Attribut öffentliche SSH-Schlüssel konfigurieren, die eine Verbindung zu VMs in diesem Projekt herstellen können. Sollte es mehrere SSH-Schlüssel geben, wird jeder Schlüssel durch ein Zeilenvorschubzeichen abgetrennt (\n). Der Wert des ssh-keys-Attributs ist ein String.

Beispiel: "user1:ssh-rsa mypublickey user1@host.com\nuser2:ssh-rsa mypublickey user2@host.com"
sshKeys Verworfen: Verwenden Sie ssh-keys.
vmdnssetting

Aktivieren Sie zonales DNS und globales DNS für die VMs in Ihrem Projekt.

Weitere Informationen zur Verwendung von zonalen DNS-Namen für Ihre VMs finden Sie unter Zonales DNS für Ihren internen DNS-Typ verwenden.

Vordefinierte Instanzmetadatenschlüssel

Vordefinierte Metadatenschlüssel für Instanzmetadaten werden im folgenden Verzeichnis gespeichert:

  • http://metadata.google.internal/computeMetadata/v1/instance/

Die folgende Tabelle enthält eine Liste der Metadatenschlüssel und -verzeichnisse, die Compute Engine automatisch im Metadatenverzeichnis instance/ erstellt:

Metadateneintrag Beschreibung
attributes/

Ein Verzeichnis mit benutzerdefinierten Metadatenwerten, die die Instanz beim Starten oder beim Beenden erhält. Diese benutzerdefinierten Werte können entweder Cloud de Confiance by S3NS-Attribute oder von Nutzern erstellte Metadatenwerte sein.

Eine Liste der Cloud de Confiance by S3NS Attribute auf Instanzebene, die Sie festlegen können, finden Sie unter Instanzattribute.

Weitere Informationen zum Festlegen benutzerdefinierter Metadaten finden Sie unter Benutzerdefinierte Metadaten festlegen.
cpu-platform

CPU-Plattform der VM.

Informationen zu CPU-Plattformen finden Sie unter CPU-Plattformen.
description Die Freitextbeschreibung einer Instanz, die mithilfe des Flags --description über die Google Cloud CLI oder die API zugewiesen wird.
disks/

Ein Verzeichnis der Laufwerke, die an die VM angehängt sind. Für jedes Laufwerk sind die folgenden Informationen verfügbar:

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

Weitere Informationen zu Laufwerken finden Sie unter Speicheroptionen.

gce-workload-certificates/ (Verworfen)

Speichert die folgenden Endpunkte für das Feature für verwaltete Arbeitslastidentitäten, das von Anwendungen verwendet wird, die auf der VM ausgeführt werden.

  • config-status: Enthält alle Fehler in den Konfigurationswerten, die über die VM-Metadaten bereitgestellt werden.
  • workload-identities: Enthält die von der Compute Engine-Steuerungsebene verwalteten Identitäten. Dieser Endpunkt enthält das X.509-Zertifikat und den privaten Schlüssel für die Vertrauensdomäne der VM.
  • trust-anchors: Enthält eine Reihe vertrauenswürdiger Zertifikate für die Validierung der X.509-Zertifikatskette des Peers.

Weitere Informationen finden Sie unter Arbeitslasten über mTLS bei anderen Arbeitslasten authentifizieren.

guest-attributes/

Legt Gastattribute für die VM fest. Diese benutzerdefinierten Werte können entweder Cloud de Confiance by S3NS-Attribute oder von Nutzern erstellte Metadatenwerte sein.

Eine Liste der Cloud de Confiance by S3NS Attribute auf Instanzebene, die Sie festlegen können, finden Sie unter Instanzattribute für Instanzen.

Weitere Informationen zu Gastattributen finden Sie unter Gastattribute festlegen und abfragen.

hostname Der Hostname der VM.
id Die ID der VM. Hierbei handelt es sich um eine eindeutige numerische ID, die von Compute Engine für Ihr Projekt und die Zone der VM generiert wird. Sie können diese ID verwenden, um Ihre VM zu identifizieren, insbesondere wenn Sie der VM keinen benutzerdefinierten Namen zugewiesen haben.
image Das von der VM verwendete Betriebssystem-Image. Dieser Wert hat folgendes Format: projects/IMAGE_PROJECT/global/images/IMAGE_NAME
legacy-endpoint-access/ Liste der Legacy-Endpunkte. Mögliche Werte sind 0.1 und v1beta1.
licenses/ Eine Liste mit Lizenzcode-IDs, mit denen die Lizenzen an Images, Snapshots und Laufwerke angehängt werden.
machine-type Der Maschinentyp für diese VM. Dieser Wert hat folgendes Format: projects/PROJECT_NUM/machineTypes/MACHINE_TYPE
maintenance-event Gibt an, ob sich ein Wartungsereignis auf diese VM auswirkt. Weitere Informationen finden Sie unter Live-Migration.
name Der Name der VM.
network-interfaces/

Ein Verzeichnis mit Netzwerkschnittstellen. Für jede Netzwerkschnittstelle sind die folgenden Informationen verfügbar:

  • access-configs/: Verzeichnis mit Zugriffskonfigurationen für diese Schnittstelle. Es wird nur 0/ unterstützt, das Details für eine 1:1-NAT-Zugriffskonfiguration enthält. Unter access-configs/0/:
    • external-ip: Die externe IP-Adresse dieser Schnittstelle.
    • type: Der Typ der Zugriffskonfiguration. Derzeit ist ONE_TO_ONE_NAT der einzige angegebene Wert.
  • dns-servers: Eine Liste der DNS-Nameserver für diese Schnittstelle.
  • forwarded-ips/: Verzeichnis mit IP-Adressen, die per Load-Balancing oder Protokollweiterleitung an diese Instanz weitergeleitet werden. Jeder Eintrag ist eine IP-Adresse.
  • forwarded-ipv6s/: Verzeichnis mit IPv6-CIDR-Bereichen, die mithilfe von Load-Balancing oder Protokollweiterleitung an diese Instanz weitergeleitet werden. Jeder Eintrag ist ein IPv6-CIDR-Bereich.
  • gateway: Die Gateway-Adresse für diese Netzwerkschnittstelle.
  • gateway-ipv6: Die IPv6-Gateway-Adresse für diese Netzwerkschnittstelle.
  • ip: Die zugewiesene interne IP-Adresse für diese Netzwerkschnittstelle.
  • ip-aliases/: Verzeichnis mit IP-Aliasbereichen, die dieser Netzwerkschnittstelle zugewiesen sind. Jeder Eintrag ist ein IP-Aliasbereich.
  • ipv6: Eine Liste der IPv6-CIDR-Bereiche, die der Netzwerkschnittstelle zugewiesen sind.
  • ipv6s: Eine Liste der IPv6-Adressen oder ‑Präfixe, die der Netzwerkschnittstelle zugewiesen sind.
  • mac: Die MAC-Adresse für diese Netzwerkschnittstelle.
  • mtu: Die MTU für diese Netzwerkschnittstelle.
  • network: Das Netzwerk für diese Schnittstelle im Format projects/PROJECT_ID/networks/NETWORK_NAME.
  • subnetmask: Die Subnetzmaske für diese Netzwerkschnittstelle.
  • target-instance-ips: Die Liste der internen IP-Adressen von Weiterleitungsregeln, die auf diese Instanz ausgerichtet sind.

Weitere Informationen zu Netzwerkschnittstellen finden Sie unter Übersicht über mehrere Netzwerkschnittstellen.

partner-attributes/ (Verworfen)

Ein Verzeichnis mit Namespaces, in denen Metadateneinträge gespeichert werden. Die Namespaces werden von Cloud de Confiance -Diensten erstellt, die Partnerattribute zum Speichern ihrer Konfigurationen verwenden. Wenn keine Dienste die Partnerattribute verwenden, ist das Verzeichnis leer.

Bei verwalteten Arbeitslastidentitäten werden beispielsweise Partnerattribute für die Konfigurationen verwendet.

preempted

Ein boolescher Wert, der angibt, ob eine VM bald vorzeitig beendet wird.
scheduling/

Legt die Zeitplanoptionen für die VM fest.

Die Planung der Metadatenwerte umfasst Folgendes:

  • on-host-maintenance: gibt an, ob die VM während der Hostwartung beendet oder live migriert wird.
  • automatic-restart: Wenn dieser Wert TRUE ist, wird die VM nach einem Wartungs- oder Absturzereignis automatisch neu gestartet.
  • preemptible: Wenn dieser Wert TRUE ist, ist die VM auf Abruf verfügbar. Dieser Wert wird beim Erstellen einer VM festgelegt und kann nicht geändert werden.

Weitere Informationen zu den Planungsoptionen finden Sie unter Verfügbarkeitsrichtlinien von Instanzen festlegen.

service-accounts/

Ein Verzeichnis mit Dienstkonten für diese Instanz. Für jedes Dienstkonto sind folgende Informationen verfügbar:

  • aliases
  • email: Die E-Mail-Adresse des Dienstkontos.
  • identity: Ein JSON-Webtoken, das für die Instanz eindeutig ist. Für diesen Instanzmetadatenwert müssen Sie den Parameter audience in Ihrer Anfrage angeben. Beispiel: ?audience=http://www.example.com

    Informationen zum Anfordern und Prüfen von Instanzidentitätstoken finden Sie unter VM-Identität prüfen.

  • scopes: Die Zugriffsbereiche, die dem Dienstkonto zugewiesen sind.
  • token: Ein OAuth2-Zugriffstoken, das zur Authentifizierung von Anwendungen verwendet werden kann.

    Weitere Informationen zu Zugriffstoken finden Sie unter Anwendungen direkt mit Zugriffstoken authentifizieren.

Weitere Informationen zur Verwendung von Dienstkonten durch Compute Engine finden Sie unter Dienstkonten.

tags

Listet alle Netzwerk-Tags auf, die der VM zugeordnet sind.

Weitere Informationen zu Netzwerktags finden Sie unter Netzwerktags konfigurieren.
virtual-clock/drift-token

Die kumulierte Abweichung der VM-Uhr. Wird bei der Instanzerstellung auf null initialisiert und durch die kumulierte Taktabweichung erhöht, wenn die VM live migriert wird.
zone Die Zone, in der sich die VM befindet. Dieser Wert hat folgendes Format: projects/PROJECT_NUM/zones/ZONE

Vordefinierte Instanzattribut-Metadatenschlüssel

Vordefinierte Metadatenschlüssel für Instanzattribute werden im folgenden Verzeichnis gespeichert:

  • http://metadata.google.internal/computeMetadata/v1/instance/attributes/

Die folgende Tabelle enthält eine Liste der Metadatenschlüssel, die Compute Engine im Metadatenverzeichnis instance/attributes/ erstellt, wenn sie für Ihre Instanz festgelegt sind, sowie die zugehörige Wirkung:

Metadateneintrag Beschreibung
physical_host_topology

Ein Hash-String, der den physischen Standort einer VM innerhalb einer Zone darstellt.

Weitere Informationen zu diesem Attribut finden Sie unter Physische VM-Standorte prüfen.

enable-windows-ssh (Vorabversion)

Aktiviert oder deaktiviert SSH für Windows-VMs.

Weitere Informationen finden Sie unter Verbindung zu Windows-VMs über SSH herstellen.

enable-workload-certificate (Verworfen)

Aktiviert oder deaktiviert verwaltete Arbeitslastidentitäten auf einer VM.

Weitere Informationen finden Sie unter Verwaltete Arbeitslastidentitäten für einzelne VMs aktivieren.
vmdnssetting

Zonales DNS und globales DNS für die VM aktivieren

Weitere Informationen zur Verwendung von zonalen DNS-Namen für das DNS Ihrer VMs finden Sie unter Zonales DNS für Ihren internen DNS-Typ verwenden.

ssh-keys

Wenn Sie SSH-Schlüssel mithilfe von Metadaten verwalten, können Sie mit diesem Attribut öffentliche SSH-Schlüssel konfigurieren, die eine Verbindung zu VMs in diesem Projekt herstellen können. Sollte es mehrere SSH-Schlüssel geben, wird jeder Schlüssel durch ein Zeilenvorschubzeichen abgetrennt (\n). Der Wert des ssh-keys-Attributs ist ein String.

Beispiel: "user1:ssh-rsa mypublickey user1@host.com\nuser2:ssh-rsa mypublickey user2@host.com"
block-project-ssh-keys

Projekt-SSH-Schlüssel für VMs mit metadatenbasierten SSH-Schlüsseln blockieren.

Weitere Informationen finden Sie unter SSH-Schlüssel von VMs einschränken.
disable-https-mds-setup

Deaktiviert die automatische Bereitstellung von HTTPS-Metadatenserverzertifikaten durch Compute Engine.

Weitere Informationen finden Sie unter Automatische Einrichtung von Zertifikaten aktivieren.
enable-https-mds-native-cert-store

Ermöglicht es Compute Engine, das Root-Zertifikat während der automatischen Bereitstellung von HTTPS-Metadatenserverzertifikaten dem Betriebssystem-Vertrauensspeicher hinzuzufügen.

Weitere Informationen finden Sie unter Speichern von Root-Zertifikaten im OS-Trust Store aktivieren.

Vordefinierte Metadatenattribute für Gastattribute

Vordefinierte Metadatenschlüssel für Gastattribute von Instanzen werden im folgenden Verzeichnis gespeichert:

  • http://metadata.google.internal/computeMetadata/v1/instance/guest-attributes/

Die folgende Tabelle enthält eine Liste der Metadatenschlüssel und -verzeichnisse, die Compute Engine automatisch im Metadatenverzeichnis instance/guest-attributes/ erstellt:

Metadateneintrag Beschreibung
guestInventory/

Speichert OS Inventory für die VM.

Erfasst und speichert Betriebssysteminformationen. Dazu gehören Informationen wie Hostname, Kernel-Version, Architektur und installierte Paketdetails.

Weitere Informationen zu OS Inventory finden Sie unter Betriebssystemdetails ansehen.

hostkeys/

Speichert SSH-Hostschlüssel. Hostschlüssel können zur Identifizierung eines bestimmten Hosts oder Computers verwendet werden.

Informationen zu Hostschlüsseln finden Sie unter Hostschlüssel speichern, indem Sie Gastattribute aktivieren.

Nächste Schritte