Hostwartungsrichtlinie für eine Compute-Instanz festlegen


In diesem Dokument wird beschrieben, wie Sie die Hostwartungsrichtlinie für eine Compute Engine-Instanz festlegen, um ihr Verhalten bei Hostereignissen zu bestimmen. Weitere Informationen zu Hostwartungsrichtlinien finden Sie unter Hostwartungsrichtlinie.

Eine Hostwartungsrichtlinie bestimmt, wie Ihre Instanz reagiert, wenn der Host, auf dem die Instanz ausgeführt wird, gewartet werden muss oder ein Fehler auftritt. Wenn Sie die Hostwartungsrichtlinie für eine Instanz konfigurieren, können Sie Folgendes tun:

  • Ausfallzeiten minimieren.

  • Datenverlust verhindern

Beschränkungen

Für Wartungsrichtlinien für Hosts gelten die folgenden Einschränkungen:

  • VM-Instanzen mit E2-Maschinentypen können nur während Hostwartungsereignissen live migriert werden, es sei denn, es handelt sich um Spot-VMs oder VMs auf Abruf.

  • Die folgenden Instanzen können nur während Hostwartungsereignissen beendet werden:

    • Instanzen, die keine Live-Migration unterstützen, z. B. Z3-Instanzen mit mehr als 18 TiB angehängter Titanium-SSD, Bare-Metal-Instanzen oder VMs mit angehängten GPUs.

    • Spot-VMs oder VMs auf Abruf.

  • Spot-VMs und VMs auf Abruf können nach Hostfehlern oder geplanten Stopps nicht automatisch neu gestartet werden.

Hinweise

  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud -Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren.
    <x0A>

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

      1. After installing the Google Cloud CLI, initialize it by running the following command:

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      2. Set a default region and zone.
      3. REST

        Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

          After installing the Google Cloud CLI, initialize it by running the following command:

          gcloud init

          If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

        Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie zum Festlegen der Hostwartungsrichtlinie für eine Compute-Instanz benötigen, bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) für Ihr Projekt zu gewähren. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Festlegen der Hostwartungsrichtlinie für eine Compute-Instanz erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um die Hostwartungsrichtlinie für eine Compute-Instanz festzulegen:

  • So erstellen Sie eine Instanz:
    • compute.instances.create für das Projekt
    • Zur Erstellung der VM mit einem benutzerdefinierten Image: compute.images.useReadOnly für das Image
    • Zur Erstellung der VM mithilfe eines Snapshots: compute.snapshots.useReadOnly für den Snapshot
    • Zur Erstellung der VM mithilfe einer Instanzvorlage: compute.instanceTemplates.useReadOnly für die Instanzvorlage
    • Um der VM ein Legacy-Netzwerk zuzuweisen: compute.networks.use für das Projekt
    • Zum Festlegen einer statische IP-Adresse für die VM: compute.addresses.use für das Projekt
    • Zur Zuweisung einer externen IP-Adresse zur VM bei Verwendung eines Legacy-Netzwerks: compute.networks.useExternalIp für das Projekt
    • Um ein Subnetz für die VM anzugeben: compute.subnetworks.use für das Projekt oder für das ausgewählte Subnetz
    • Um der VM eine externe IP-Adresse zuzuweisen, wenn Sie ein VPC-Netzwerk verwenden: compute.subnetworks.useExternalIp für das Projekt oder für das ausgewählte Subnetz
    • Um die Metadaten der VM-Instanz für die VM festzulegen: compute.instances.setMetadata für das Projekt
    • Um Tags für die VM festzulegen: compute.instances.setTags für die VM
    • Um Labels für die VM festzulegen: compute.instances.setLabels für die VM
    • Um ein Dienstkonto festzulegen, das die VM verwenden soll: compute.instances.setServiceAccount für die VM
    • Um ein neues Laufwerk für die VM zu erstellen: compute.disks.create für das Projekt
    • Um ein vorhandenes Laufwerk im Lese- oder Lese‑/Schreibmodus anzuhängen: compute.disks.use für das Laufwerk
    • Um ein vorhandenes Laufwerk im Lesemodus anzuhängen: compute.disks.useReadOnly für das Laufwerk
  • Um eine Instanzvorlage zu erstellen: compute.instanceTemplates.create für das Projekt
  • So aktualisieren Sie die Hostwartungsrichtlinie für eine Instanz: compute.instances.setScheduling auf der Instanz

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Verfügbare Hostwartungseigenschaften

Sie können anpassen, wie sich Ihre Compute-Instanz bei geplanten Wartungen oder unerwarteten Hostereignissen verhält. Sofern Sie nichts anderes angeben, verwendet Compute Engine Standardeinstellungen, wenn Sie eine-Instanz, mehrere Instanzen gleichzeitig oder eine Instanzvorlage erstellen.

Sie können die folgenden Hostwartungseigenschaften konfigurieren:

  • Wartungsverhalten (onHostMaintenance): Was mit Ihrer Instanz während eines Wartungsereignisses auf dem Host passiert, das zum Neustart der Instanz führen kann. Sie können diese Eigenschaft auf einen der folgenden Werte festlegen:

    • Migrieren: Compute Engine migriert Ihre Instanz automatisch per Live-Migration zu einem anderen Host. Dies ist die Standardeinstellung für alle Arten von Instanzen, mit Ausnahme von Spot-VMs und preemptible VMs.

    • Beenden: Compute Engine beendet Ihre Instanz. Dies ist die Standardeinstellung für Spot-VMs oder VMs mit Vorabnutzung und die einzige unterstützte Einstellung für Z3-Instanzen mit mehr als 18 TiB angehängter Titanium-SSD, Bare-Metal-Instanzen und Instanzen mit angehängten GPUs oder TPUs.

  • Automatischer Neustart (automaticRestart): Gibt an, ob Ihre Instanz neu gestartet wird, wenn sie abstürzt oder von Compute Engine für einen geplanten Stopp beendet wird, z. B. bei einem Wartungsereignis. Sie können diese Eigenschaft auf einen der folgenden Werte festlegen:

    • Ein: Compute Engine startet die Instanz automatisch neu. Dies ist die Standardeinstellung für alle Arten von Instanzen, mit Ausnahme von Spot-VMs und VMs auf Abruf. So legen Sie diese Einstellung fest:

      • Wählen Sie für die Google Cloud -Konsole im Bereich Erweitert in der Liste Automatischer Neustart die Option An (empfohlen) aus.

      • Verwenden Sie für die Google Cloud CLI das Flag --restart-on-failure.

      • Legen Sie für REST das Feld automaticRestart auf true fest.

    • Aus: Compute Engine startet die Instanz nicht neu. Dies ist die Standardeinstellung für Spot-VMs oder VMs auf Abruf. So legen Sie diese Einstellung fest:

      • Wählen Sie für die Google Cloud -Konsole im Bereich Erweitert in der Liste Automatischer Neustart die Option Aus aus.

      • Verwenden Sie für die gcloud CLI das Flag --no-restart-on-failure.

      • Legen Sie für REST das Feld automaticRestart auf false fest.

  • Zeitlimit für die Wiederherstellung lokaler SSD-Daten (localSsdRecoveryTimeout): Diese Einstellung gilt nur für Instanzen, an die lokale SSD-Laufwerke angehängt sind. Damit wird festgelegt, wie lange Compute Engine nach Hostfehlern wartet, um Daten von Ihren lokalen SSD-Laufwerken wiederherzustellen. Standardmäßig ist dieses Attribut nicht festgelegt. Sie können dieses Attribut auf einen der folgenden Werte festlegen:

    • Nicht festgelegt: Compute Engine verwendet die Standardwartezeit:

      • Für Z3-VMs: 6 Stunden

      • Für alle anderen Instanztypen: 1 Stunde

    • Ganzzahl zwischen 0 und 168: die Anzahl der Stunden, die gewartet werden soll. Wenn Sie diese Eigenschaft auf 0 festlegen, stellt Compute Engine keine lokalen SSD-Daten wieder her und startet die Instanz sofort neu.

  • Zeitlimit für Hostfehler (hostErrorTimeoutSeconds): Mit dieser Eigenschaft wird festgelegt, wie lange Compute Engine auf den Neustart einer nicht reagierenden Instanz wartet. Sie müssen diese Einstellung konfigurieren, bevor die Instanz nicht mehr reagiert. Verwenden Sie ein Zeitlimit, das lang genug ist, damit sich eine Instanz von einer Situation erholen kann, in der sie nicht reagiert. Sie können diese Eigenschaft auf einen der folgenden Werte festlegen:

    • Nicht festgelegt: Compute Engine wartet bis zu 330 Sekunden (5 Minuten und 30 Sekunden). Dies ist die Standardeinstellung für alle Arten von Instanzen.

    • Eine Ganzzahl zwischen 90 und 330: Die Wartezeit in Sekunden in Schritten von 30 Sekunden.

Hostwartungsrichtlinie für eine Instanz festlegen

Compute-Instanzen verwenden standardmäßig die Standardeinstellungen für ihre Hostwartungsrichtlinie. Verwenden Sie eine der folgenden Methoden, um diese Einstellungen anzupassen:

Richtlinie für eine vorhandene Instanz festlegen

Bevor Sie die Hostwartungsrichtlinie einer vorhandenen Instanz ändern, müssen Sie Folgendes beachten:

  • Sie können das Wartungsverhalten (onHostMaintenance) der folgenden Instanztypen nicht ändern:

  • Sie können Spot-VMs oder VMs auf Abruf nicht so konfigurieren, dass sie nach Hostfehlern oder geplanten Stopps automatisch neu gestartet werden.

Wenn Sie das Zeitlimit für die Datenwiederherstellung auf lokalen SSDs in einer Instanz mit angehängten lokalen SSD-Laufwerken ändern möchten, verwenden Sie die gcloud CLI oder die REST API. Wählen Sie andernfalls eine der folgenden Optionen aus:

Console

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf:

    Zu „VM-Instanzen“

  2. Klicken Sie in der Spalte Name auf den Namen der Instanz, die Sie aktualisieren möchten. Eine Seite mit den Details der Instanz wird angezeigt.

  3. Klicken Sie auf  Bearbeiten. Es wird eine Seite angezeigt, auf der Sie Instanzeigenschaften bearbeiten können.

  4. Im Bereich Verwaltung können Sie einen oder mehrere der folgenden Schritte ausführen:

    • Wenn Sie das Verhalten bei Wartungsereignissen ändern möchten, wählen Sie eine andere Option aus der Liste Bei Hostwartung aus.

    • Wenn Sie den Zeitraum für das Zeitlimit ändern möchten, bevor eine nicht reagierende Instanz neu gestartet wird, wählen Sie in der Liste Host error timeout (Zeitlimit für Hostfehler) eine andere Option aus.

    • Wenn Sie ändern möchten, ob die Instanz nach Hostfehlern oder geplanten Stopps neu gestartet werden soll, wählen Sie eine andere Option aus der Liste Automatischer Neustart aus.

  5. Klicken Sie auf Speichern.

gcloud

Verwenden Sie zum Ändern der Hostwartungsrichtlinie in einer vorhandenen Instanz den Befehl gcloud compute instances set-scheduling mit einem oder mehreren der folgenden Flags:

  • Wenn Sie das Verhalten bei der Hostwartung ändern möchten, fügen Sie das Flag --maintenance-policy ein.

  • So ändern Sie das Verhalten beim automatischen Neustart:

    • Wenn die Instanz automatisch neu gestartet werden soll, fügen Sie das Flag --restart-on-failure ein.

    • Wenn Sie verhindern möchten, dass die Instanz automatisch neu gestartet wird, fügen Sie das Flag --no-restart-on-failure ein.

  • Wenn Sie das Zeitlimit für die Wiederherstellung lokaler SSD-Daten ändern möchten und an Ihre Instanz lokale SSD-Laufwerke angehängt sind, fügen Sie das Flag --local-ssd-recovery-timeout ein.

  • Wenn Sie das Zeitlimit für Hostfehler ändern möchten, fügen Sie das Flag --host-error-timeout-seconds ein.

Wenn Sie beispielsweise das Verhalten bei der Hostwartung ändern, die Instanz nach Hostfehlern oder geplanten Stopps automatisch neu starten, das Zeitlimit für die Wiederherstellung lokaler SSD-Daten und das Zeitlimit für Hostfehler ändern möchten, führen Sie den folgenden Befehl aus:

gcloud compute instances set-scheduling INSTANCE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: Der Name der Instanz.

  • ERROR_DETECTION_TIMEOUT: Die Anzahl der Sekunden, bevor Compute Engine eine nicht reagierende Instanz neu startet. Der Wert muss zwischen 90 (90 Sekunden) und 330 (330 Sekunden oder 5 Minuten und 30 Sekunden) liegen. Es sind nur 30-Sekunden-Schritte zulässig.

  • MAINTENANCE_POLICY: Das Wartungsverhalten der Instanz. Der Wert kann TERMINATE oder MIGRATE sein.

  • LOCAL_SSD_RECOVERY_TIMEOUT: Anzahl der Stunden, die für die Wiederherstellung von Daten von den angehängten lokalen SSD-Laufwerken benötigt werden. Der Wert muss zwischen 0 (0 Stunden) und 168 (168 Stunden oder 7 Tage) liegen. Wenn Sie dieses Feld auf 0 setzen, stellt Compute Engine keine lokalen SSD-Daten wieder her.

  • ZONE: die Zone, in der sich Ihre Instanz befindet.

REST

Wenn Sie die Hostwartungsrichtlinie in einer vorhandenen Instanz ändern möchten, senden Sie eine POST-Anfrage an die Methode instances.setScheduling. Geben Sie im Anfragetext eines oder mehrere der folgenden Felder an:

  • Wenn Sie das Verhalten bei der Hostwartung ändern möchten, fügen Sie das Feld onHostMaintenance ein.

  • So ändern Sie das Verhalten beim automatischen Neustart:

    • Wenn die Instanz automatisch neu gestartet werden soll, fügen Sie das Feld automaticRestart ein.

    • Wenn Sie verhindern möchten, dass die Instanz automatisch neu gestartet wird, fügen Sie das Feld automaticRestart ein.

  • Wenn an Ihre Instanz lokale SSD-Laufwerke angehängt sind, können Sie das Zeitlimit für die Wiederherstellung lokaler SSD-Daten ändern, indem Sie das Feld localSsdRecoveryTimeout einfügen.

  • Wenn Sie das Zeitlimit für Hostfehler ändern möchten, fügen Sie das Feld hostErrorTimeoutSeconds ein.

Wenn Sie beispielsweise das Verhalten bei der Hostwartung ändern, die Instanz nach Hostfehlern oder geplanten Stopps automatisch neu starten, das Zeitlimit für die Wiederherstellung lokaler SSD-Daten ändern und das Zeitlimit für Hostfehler ändern möchten, stellen Sie eine Anfrage wie folgt:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/setScheduling

{
  "automaticRestart": AUTOMATIC_RESTART,
  "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
  "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
  "onHostMaintenance": "MAINTENANCE_POLICY"
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, in dem sich die Instanz befindet.

  • ZONE: die Zone, in der sich Ihre Instanz befindet.

  • INSTANCE_NAME: Der Name der Instanz.

  • AUTOMATIC_RESTART: Das Verhalten beim automatischen Neustart der Instanz, wenn sie abstürzt oder von Compute Engine für einen geplanten Stopp beendet wird. Geben Sie einen der folgenden Werte an:

    • So lassen Sie Ihre Instanz automatisch von Compute Engine neu starten: true

    • So verhindern Sie automatische Neustarts: false

  • ERROR_DETECTION_TIMEOUT: Die Anzahl der Sekunden, bevor eine nicht reagierende Instanz neu gestartet wird. Der Wert muss zwischen 90 (90 Sekunden) und 330 (330 Sekunden oder 5 Minuten und 30 Sekunden) liegen. Es sind nur 30-Sekunden-Schritte zulässig.

  • LOCAL_SSD_RECOVERY_TIMEOUT: Anzahl der Stunden, die für die Wiederherstellung von Daten von den angehängten lokalen SSD-Laufwerken benötigt werden. Der Wert muss zwischen 0 (0 Stunden) und 168 (168 Stunden oder 7 Tage) liegen. Wenn Sie dieses Feld auf 0 setzen, stellt Compute Engine keine lokalen SSD-Daten wieder her.

  • MAINTENANCE_POLICY: Das Wartungsverhalten der Instanz. Der Wert kann TERMINATE oder MIGRATE sein.

Richtlinie beim Erstellen einer Instanz festlegen

Sie können die Hostwartungsrichtlinie einer Compute-Instanz beim Erstellen festlegen.

Wenn Sie beim Erstellen einer Instanz mit angehängten lokalen SSD-Laufwerken das Zeitlimit für die Datenwiederherstellung auf lokalen SSDs festlegen möchten, verwenden Sie die gcloud CLI oder die REST API. Wählen Sie andernfalls eine der folgenden Optionen aus:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Instanz erstellen auf.

    Zur Seite „Instanz erstellen“

  2. Geben Sie im Feld Name einen Namen für die Instanz ein.

  3. Geben Sie in den Feldern Region und Zone an, in welcher Region und Zone die Instanz erstellt werden soll.

  4. Geben Sie den Maschinentyp für die Instanz an.

  5. Klicken Sie im Navigationsmenü auf Erweitert.

  6. Maximieren Sie im Abschnitt Bereitstellungsmodell die Option Erweiterte Einstellungen für das VM-Bereitstellungsmodell und führen Sie dann einen oder mehrere der folgenden Schritte aus:

    • Wenn Sie das Verhalten während Wartungsereignissen festlegen möchten, wählen Sie in der Liste Bei Hostwartung eine der folgenden Optionen aus:

      • Wenn Sie die Instanz während Hostwartungsereignissen migrieren möchten, wählen Sie VM-Instanz migrieren (empfohlen) aus.

      • Wenn Sie die Instanz während Hostwartungsereignissen beenden möchten, wählen Sie VM-Instanz beenden aus.

    • Wenn Sie den Zeitüberschreitungszeitraum festlegen möchten, bevor eine nicht reagierende Instanz neu gestartet wird, wählen Sie in der Liste Host-Fehler-Zeitüberschreitung eine der folgenden Optionen aus:

      • Wenn Sie kein Zeitlimit für Hostfehler angeben möchten, wählen Sie Nicht angegeben (Standard) aus.

      • Wenn Sie ein Zeitlimit für Hostfehler festlegen möchten, wählen Sie eine der verfügbaren Optionen aus, bis zu 5 Minuten und 30 Sekunden.

    • Wenn Sie festlegen möchten, ob die Instanz neu gestartet werden soll, wenn sie abstürzt oder beendet wird, wählen Sie in der Liste Automatischer Neustart eine der folgenden Optionen aus:

      • Wenn die Instanz nach Hostfehlern oder geplanten Stopps automatisch neu gestartet werden soll, wählen Sie An (empfohlen) aus.

      • Wenn Sie verhindern möchten, dass die Instanz nach Hostfehlern oder programmierten Stopps automatisch neu gestartet wird, wählen Sie Aus aus.

  7. Klicken Sie auf Erstellen.

gcloud

Wenn Sie die Hostwartungsrichtlinie einer Instanz beim Erstellen festlegen möchten, verwenden Sie den Befehl gcloud compute instances create mit einem oder mehreren der folgenden Flags:

  • Wenn Sie das Verhalten bei der Hostwartung festlegen möchten, fügen Sie das Flag --maintenance-policy ein.

  • Führen Sie einen der folgenden Schritte aus, um das Verhalten beim automatischen Neustart festzulegen:

    • Wenn die Instanz automatisch neu gestartet werden soll, fügen Sie das Flag --restart-on-failure ein.

    • Wenn Sie verhindern möchten, dass die Instanz automatisch neu gestartet wird, fügen Sie das Flag --no-restart-on-failure ein.

  • Wenn Sie ein Zeitlimit für die Wiederherstellung von lokalen SSD-Daten festlegen möchten und an Ihre Instanz lokale SSD-Laufwerke angehängt sind, fügen Sie das Flag --local-ssd-recovery-timeout ein.

  • Fügen Sie das Flag --host-error-timeout-seconds ein, um ein Zeitlimit für Hostfehler festzulegen.

Wenn Sie beispielsweise das Hostwartungsverhalten festlegen, die Instanz nach Hostfehlern oder geplanten Stopps automatisch neu starten, ein Zeitlimit für die Wiederherstellung lokaler SSD-Daten und ein Zeitlimit für Hostfehler festlegen möchten, führen Sie den folgenden Befehl aus:

gcloud compute instances create INSTANCE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name der Instanz.

  • ERROR_DETECTION_TIMEOUT: Die Anzahl der Sekunden, bevor eine nicht reagierende Instanz neu gestartet wird. Der Wert muss zwischen 90 (90 Sekunden) und 330 (330 Sekunden oder 5 Minuten und 30 Sekunden) liegen. Es sind nur 30-Sekunden-Schritte zulässig.

  • LOCAL_SSD_RECOVERY_TIMEOUT: Anzahl der Stunden, die für die Wiederherstellung von Daten von den angehängten lokalen SSD-Laufwerken benötigt werden. Der Wert muss zwischen 0 (0 Stunden) und 168 (168 Stunden oder 7 Tage) liegen. Wenn Sie dieses Feld auf 0 setzen, stellt Compute Engine keine lokalen SSD-Daten wieder her.

  • MACHINE_TYPE ist der zu verwendende Maschinentyp.

  • MAINTENANCE_POLICY: Das Wartungsverhalten der Instanz. Der Wert kann TERMINATE oder MIGRATE sein. Wenn Sie eine Spot-VM, eine VM auf Abruf oder eine Instanz erstellen, die keine Live-Migration unterstützt, können Sie nur TERMINATE verwenden.

  • ZONE: Die Zone, in der die Instanz erstellt werden soll.

REST

Wenn Sie die Hostwartungsrichtlinie einer Instanz beim Erstellen festlegen möchten, senden Sie eine POST-Anfrage an die Methode instances.insert. Geben Sie im Anfragetext im Feld scheduling eines oder mehrere der folgenden Felder an:

  • Fügen Sie das Feld onHostMaintenance ein, um das Verhalten bei der Hostwartung festzulegen.

  • Führen Sie einen der folgenden Schritte aus, um das Verhalten beim automatischen Neustart festzulegen:

    • Wenn die Instanz automatisch neu gestartet werden soll, fügen Sie das Feld automaticRestart ein.

    • Wenn Sie verhindern möchten, dass die Instanz automatisch neu gestartet wird, fügen Sie das Feld automaticRestart ein.

  • Wenn an Ihre Instanz lokale SSD-Laufwerke angehängt sind, fügen Sie das Feld localSsdRecoveryTimeout ein, um ein Zeitlimit für die Wiederherstellung von lokalen SSD-Daten festzulegen.

  • Wenn Sie ein Zeitlimit für Hostfehler festlegen möchten, fügen Sie das Feld hostErrorTimeoutSeconds ein.

Wenn Sie beispielsweise das Hostwartungsverhalten festlegen, die Instanz nach Hostfehlern oder geplanten Stopps automatisch neu starten, ein Zeitlimit für die Wiederherstellung lokaler SSD-Daten und ein Zeitlimit für Hostfehler festlegen möchten, stellen Sie eine Anfrage wie die folgende:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "INSTANCE_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "scheduling": {
    "automaticRestart": AUTOMATIC_RESTART,
    "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
    "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
    "onHostMaintenance": "MAINTENANCE_POLICY"
  }
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: Die ID des Projekts, in dem die Instanz erstellt werden soll.

  • ZONE: Die Zone, in der die Instanz erstellt werden soll.

  • INSTANCE_NAME: der Name der Instanz.

  • MACHINE_TYPE ist der zu verwendende Maschinentyp.

  • IMAGE_PROJECT: das Image-Projekt, das das Image enthält, z. B. debian-cloud. Weitere Informationen zu den unterstützten Image-Projekten finden Sie unter Öffentliche Images.

  • IMAGE: Wählen Sie eine der folgenden Optionen aus:

    • Eine bestimmte Version des Betriebssystem-Images; Beispiel: debian-12-bookworm-v20240617.

    • Eine Image-Familie, die als family/IMAGE_FAMILY formatiert sein muss. Diese gibt das neueste nicht verworfene Betriebssystem-Image an. Beispiel: Wenn Sie family/debian-12 angeben, wird die aktuelle Version in der Debian 12-Image-Familie verwendet. Weitere Informationen zur Verwendung von Image-Familien finden Sie unter Best Practices für Image-Familien.

  • AUTOMATIC_RESTART: Das Verhalten beim automatischen Neustart der Instanz, wenn sie abstürzt oder von Compute Engine für einen geplanten Stopp beendet wird. Geben Sie einen der folgenden Werte an:

    • So lassen Sie Ihre Instanz automatisch von Compute Engine neu starten: true

    • So verhindern Sie automatische Neustarts: false

  • ERROR_DETECTION_TIMEOUT: Die Anzahl der Sekunden, bevor eine nicht reagierende Instanz neu gestartet wird. Der Wert muss zwischen 90 (90 Sekunden) und 330 (330 Sekunden oder 5 Minuten und 30 Sekunden) liegen. Es sind nur 30-Sekunden-Schritte zulässig.

  • LOCAL_SSD_RECOVERY_TIMEOUT: Anzahl der Stunden, die für die Wiederherstellung von Daten von den angehängten lokalen SSD-Laufwerken benötigt werden. Der Wert muss zwischen 0 (0 Stunden) und 168 (168 Stunden oder 7 Tage) liegen. Wenn Sie dieses Feld auf 0 setzen, stellt Compute Engine keine lokalen SSD-Daten wieder her.

  • MAINTENANCE_POLICY: Das Wartungsverhalten der Instanz. Der Wert kann TERMINATE oder MIGRATE sein. Wenn Sie eine Spot-VM oder eine Instanz erstellen, die keine Live-Migration unterstützt, können Sie nur TERMINATE verwenden.

Weitere Informationen zum Erstellen einer Instanz finden Sie unter Compute Engine-Instanz erstellen und starten.

Richtlinie beim Erstellen von Instanzen im Bulk festlegen

Wenn Sie die Hostwartungsrichtlinie beim Erstellen von Instanzen im Bulk festlegen möchten, wählen Sie eine der folgenden Optionen aus:

gcloud

Wenn Sie die Hostwartungsrichtlinie beim Erstellen von Instanzen im Bulk festlegen möchten, verwenden Sie den Befehl gcloud compute instances bulk create mit einem oder mehreren der folgenden Flags:

  • Wenn Sie das Verhalten bei der Hostwartung festlegen möchten, fügen Sie das Flag --maintenance-policy ein.

  • Führen Sie einen der folgenden Schritte aus, um das Verhalten beim automatischen Neustart festzulegen:

    • Wenn die Instanz automatisch neu gestartet werden soll, fügen Sie das Flag --restart-on-failure ein.

    • Wenn Sie verhindern möchten, dass die Instanz automatisch neu gestartet wird, fügen Sie das Flag --no-restart-on-failure ein.

  • Wenn Sie ein Zeitlimit für die Wiederherstellung von lokalen SSD-Daten festlegen möchten und an Ihre Instanz lokale SSD-Laufwerke angehängt sind, fügen Sie das Flag --local-ssd-recovery-timeout ein.

  • Fügen Sie das Flag --host-error-timeout-seconds ein, um ein Zeitlimit für Hostfehler festzulegen.

Wenn Sie beispielsweise das Hostwartungsverhalten festlegen, die Instanz nach Hostfehlern oder geplanten Stopps automatisch neu starten, ein Zeitlimit für die Wiederherstellung lokaler SSD-Daten und ein Zeitlimit für Hostfehler festlegen möchten, führen Sie den folgenden Befehl aus. Im folgenden Beispiel werden auch Instanzen in einer einzelnen Zone erstellt und ein Namensmuster für die Instanzen angegeben:

gcloud compute instances bulk create \
    --count=COUNT \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --name-pattern=NAME_PATTERN \
    --restart-on-failure \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • COUNT: Die Anzahl der zu erstellenden Instanzen.

  • ERROR_DETECTION_TIMEOUT: Die Anzahl der Sekunden, bevor eine nicht reagierende Instanz neu gestartet wird. Der Wert muss zwischen 90 (90 Sekunden) und 330 (330 Sekunden oder 5 Minuten und 30 Sekunden) liegen. Es sind nur 30-Sekunden-Schritte zulässig.

  • LOCAL_SSD_RECOVERY_TIMEOUT: Anzahl der Stunden, die für die Wiederherstellung von Daten von den angehängten lokalen SSD-Laufwerken benötigt werden. Der Wert muss zwischen 0 (0 Stunden) und 168 (168 Stunden oder 7 Tage) liegen. Wenn Sie dieses Feld auf 0 setzen, stellt Compute Engine keine lokalen SSD-Daten wieder her.

  • MACHINE_TYPE ist der zu verwendende Maschinentyp.

  • MAINTENANCE_POLICY: Das Wartungsverhalten der Instanzen. Der Wert kann TERMINATE oder MIGRATE sein. Wenn Sie Spot-VMs, VMs auf Abruf oder Instanzen erstellen, die keine Live-Migration unterstützen, können Sie nur TERMINATE verwenden.

  • NAME_PATTERN ist das Namensmuster für die Instanzen. Wenn Sie eine Zahlenfolge in einem Instanznamen ersetzen möchten, verwenden Sie eine Folge von Hash-Zeichen (#). Wenn Sie z. B. instance-# für das Namensmuster verwenden, werden Instanzen mit Namen erstellt, die mit instance-1, instance-2 usw. beginnen, bis die Anzahl der in COUNT angegebenen Instanzen erreicht ist.

  • ZONE: Die Zone, in der die Instanzen erstellt werden sollen.

REST

Wenn Sie die Hostwartungsrichtlinie beim Erstellen von Instanzen im Bulk festlegen möchten, senden Sie eine POST-Anfrage an die Methode instances.bulkInsert. Geben Sie im Anfragetext im Feld scheduling eines oder mehrere der folgenden Felder an:

  • Fügen Sie das Feld onHostMaintenance ein, um das Verhalten bei der Hostwartung festzulegen.

  • Führen Sie einen der folgenden Schritte aus, um das Verhalten beim automatischen Neustart festzulegen:

    • Wenn die Instanz automatisch neu gestartet werden soll, fügen Sie das Feld automaticRestart ein.

    • Wenn Sie verhindern möchten, dass die Instanz automatisch neu gestartet wird, fügen Sie das Feld automaticRestart ein.

  • Wenn an Ihre Instanz lokale SSD-Laufwerke angehängt sind, fügen Sie das Feld localSsdRecoveryTimeout ein, um ein Zeitlimit für die Wiederherstellung von lokalen SSD-Daten festzulegen.

  • Wenn Sie ein Zeitlimit für Hostfehler festlegen möchten, fügen Sie das Feld hostErrorTimeoutSeconds ein.

Wenn Sie beispielsweise das Hostwartungsverhalten festlegen, die Instanz nach Hostfehlern oder geplanten Stopps automatisch neu starten, ein Zeitlimit für die Wiederherstellung lokaler SSD-Daten und ein Zeitlimit für Hostfehler festlegen möchten, stellen Sie eine Anfrage wie die folgende: Im folgenden Beispiel werden auch Instanzen in einer einzelnen Zone erstellt und ein Namensmuster für die Instanzen angegeben:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "automaticRestart": AUTOMATIC_RESTART,
      "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
      "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: Die ID des Projekts, in dem die Instanzen erstellt werden sollen.

  • ZONE: Die Zone, in der die Instanzen erstellt werden sollen.

  • COUNT: Die Anzahl der zu erstellenden Instanzen.

  • NAME_PATTERN ist das Namensmuster für die Instanzen. Wenn Sie eine Zahlenfolge in einem Instanznamen ersetzen möchten, verwenden Sie eine Folge von Hash-Zeichen (#). Wenn Sie z. B. instance-# für das Namensmuster verwenden, werden Instanzen mit Namen erstellt, die mit instance-1, instance-2 usw. beginnen, bis die Anzahl der in COUNT angegebenen Instanzen erreicht ist.

  • MACHINE_TYPE ist der zu verwendende Maschinentyp.

  • IMAGE_PROJECT: das Image-Projekt, das das Image enthält, z. B. debian-cloud. Weitere Informationen zu den unterstützten Image-Projekten finden Sie unter Öffentliche Images.

  • IMAGE: Wählen Sie eine der folgenden Optionen aus:

    • Eine bestimmte Version des Betriebssystem-Images; Beispiel: debian-12-bookworm-v20240617.

    • Eine Image-Familie, die als family/IMAGE_FAMILY formatiert sein muss. Diese gibt das neueste nicht verworfene Betriebssystem-Image an. Beispiel: Wenn Sie family/debian-12 angeben, wird die aktuelle Version in der Debian 12-Image-Familie verwendet. Weitere Informationen zur Verwendung von Image-Familien finden Sie unter Best Practices für Image-Familien.

  • AUTOMATIC_RESTART: Das Verhalten beim automatischen Neustart der Instanz, wenn sie abstürzt oder von Compute Engine für einen geplanten Stopp beendet wird. Geben Sie einen der folgenden Werte an:

    • So lassen Sie Ihre Instanz automatisch von Compute Engine neu starten: true

    • So verhindern Sie automatische Neustarts: false

  • ERROR_DETECTION_TIMEOUT: Die Anzahl der Sekunden, bevor eine nicht reagierende Instanz neu gestartet wird. Der Wert muss zwischen 90 (90 Sekunden) und 330 (330 Sekunden oder 5 Minuten und 30 Sekunden) liegen. Es sind nur 30-Sekunden-Schritte zulässig.

  • LOCAL_SSD_RECOVERY_TIMEOUT: Anzahl der Stunden, die für die Wiederherstellung von Daten von den angehängten lokalen SSD-Laufwerken benötigt werden. Der Wert muss zwischen 0 (0 Stunden) und 168 (168 Stunden oder 7 Tage) liegen. Wenn Sie dieses Feld auf 0 setzen, stellt Compute Engine keine lokalen SSD-Daten wieder her.

  • MAINTENANCE_POLICY: Das Wartungsverhalten der Instanzen. Der Wert kann TERMINATE oder MIGRATE sein. Wenn Sie Spot-VMs, VMs auf Abruf oder Instanzen erstellen, die keine Live-Migration unterstützen, können Sie nur TERMINATE verwenden.

Weitere Informationen zum Erstellen von Instanzen im Bulk finden Sie unter VMs im Bulk erstellen.

Richtlinie beim Erstellen einer Instanzvorlage festlegen

Sie können die Hostwartungsrichtlinie beim Erstellen einer Instanzvorlage festlegen. Alle Compute-Instanzen, die Sie mit der Vorlage erstellen, übernehmen die in der Vorlage angegebene Richtlinie für die Hostwartung.

Wenn Sie beim Erstellen einer Instanzvorlage, in der lokale SSD-Laufwerke angegeben sind, das Zeitlimit für die Wiederherstellung von Daten auf lokalen SSDs festlegen möchten, verwenden Sie die gcloud CLI oder die REST API. Wählen Sie andernfalls eine der folgenden Optionen aus:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Instanzvorlagen auf.

    Zu Instanzvorlagen

  2. Klicken Sie auf Instanzvorlage erstellen. Die Seite Instanzvorlage erstellen wird angezeigt.

  3. Geben Sie im Feld Name einen Namen für die Instanzvorlage ein.

  4. Wählen Sie im Bereich Standort eine der folgenden Optionen aus:

    • Um eine regionale Instanzvorlage zu erstellen, wählen Sie Regional (empfohlen) und dann die Region aus, in der Sie die Vorlage erstellen möchten.

    • Zum Erstellen einer globalen Instanzvorlage wählen Sie Global aus.

  5. Geben Sie im Abschnitt Maschinenkonfiguration den Maschinentyp für die Instanzvorlage an.

  6. Maximieren Sie im Abschnitt Bereitstellungsmodell die Option Erweiterte Einstellungen für das VM-Bereitstellungsmodell und führen Sie dann einen oder mehrere der folgenden Schritte aus:

    • Wenn Sie das Verhalten während Wartungsereignissen ändern möchten, wählen Sie in der Liste Bei Hostwartung eine der folgenden Optionen aus:

      • Wenn Sie die Instanz während Hostwartungsereignissen migrieren möchten, wählen Sie VM-Instanz migrieren (empfohlen) aus.

      • Wenn Sie die Instanz während Hostwartungsereignissen beenden möchten, wählen Sie VM-Instanz beenden aus.

    • Wenn Sie den Zeitüberschreitungszeitraum ändern möchten, bevor eine nicht reagierende Instanz neu gestartet wird, wählen Sie in der Liste Host error timeout (Zeitüberschreitung bei Hostfehler) eine der folgenden Optionen aus:

      • Wenn Sie kein Zeitlimit für Hostfehler angeben möchten, wählen Sie Nicht angegeben (Standard) aus.

      • Wenn Sie ein Zeitlimit für Hostfehler festlegen möchten, wählen Sie eine der verfügbaren Optionen aus, bis zu 5 Minuten und 30 Sekunden.

    • Wenn Sie ändern möchten, ob die Instanz neu gestartet werden soll, wenn sie abstürzt oder beendet wird, wählen Sie in der Liste Automatischer Neustart eine der folgenden Optionen aus:

      • Wenn die Instanz nach Hostfehlern oder geplanten Stopps automatisch neu gestartet werden soll, wählen Sie An (empfohlen) aus.

      • Wenn Sie verhindern möchten, dass die Instanz nach Hostfehlern oder programmierten Stopps automatisch neu gestartet wird, wählen Sie Aus aus.

  7. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie zum Festlegen der Hostwartungsrichtlinie beim Erstellen einer Instanzvorlage den Befehl gcloud compute instance-templates create mit einem oder mehreren der folgenden Flags:

  • Fügen Sie das Feld onHostMaintenance ein, um das Verhalten bei der Hostwartung festzulegen.

  • Führen Sie einen der folgenden Schritte aus, um das Verhalten beim automatischen Neustart festzulegen:

    • Wenn die Instanz automatisch neu gestartet werden soll, fügen Sie das Feld automaticRestart ein.

    • Wenn Sie verhindern möchten, dass die Instanz automatisch neu gestartet wird, fügen Sie das Feld automaticRestart ein.

  • Wenn an Ihre Instanz lokale SSD-Laufwerke angehängt sind, fügen Sie das Feld localSsdRecoveryTimeout ein, um ein Zeitlimit für die Wiederherstellung von lokalen SSD-Daten festzulegen.

  • Wenn Sie ein Zeitlimit für Hostfehler festlegen möchten, fügen Sie das Feld hostErrorTimeoutSeconds ein.

Wenn Sie beispielsweise das Hostwartungsverhalten festlegen, die Instanz nach Hostfehlern oder geplanten Stopps automatisch neu starten, ein Zeitlimit für die Wiederherstellung lokaler SSD-Daten und ein Zeitlimit für Hostfehler festlegen möchten, führen Sie den folgenden Befehl aus. Im folgenden Beispiel wird ebenfalls eine regionale Instanzvorlage erstellt. Wenn Sie eine globale Instanzvorlage erstellen möchten, verwenden Sie denselben Befehl ohne das Flag --instance-template-region.

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --instance-template-region=REGION \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure

Ersetzen Sie Folgendes:

  • INSTANCE_TEMPLATE_NAME ist der Name der Instanzvorlage.

  • ERROR_DETECTION_TIMEOUT: Die Anzahl der Sekunden, bevor eine nicht reagierende Instanz neu gestartet wird. Der Wert muss zwischen 90 (90 Sekunden) und 330 (330 Sekunden oder 5 Minuten und 30 Sekunden) liegen. Es sind nur 30-Sekunden-Schritte zulässig.

  • REGION: Region, in der die Instanzvorlage erstellt werden soll.

  • LOCAL_SSD_RECOVERY_TIMEOUT: Anzahl der Stunden, die für die Wiederherstellung von Daten von den angehängten lokalen SSD-Laufwerken benötigt werden. Der Wert muss zwischen 0 (0 Stunden) und 168 (168 Stunden oder 7 Tage) liegen. Wenn Sie dieses Feld auf 0 setzen, stellt Compute Engine keine lokalen SSD-Daten wieder her.

  • MACHINE_TYPE ist der zu verwendende Maschinentyp.

  • MAINTENANCE_POLICY: Das Wartungsverhalten der Instanzen. Der Wert kann TERMINATE oder MIGRATE sein. Wenn Sie in der Instanzvorlage eine Spot-VM, eine VM auf Abruf oder einen Instanztyp angeben, der keine Live-Migration unterstützt, können Sie nur TERMINATE verwenden.

REST

Wenn Sie die Hostwartungsrichtlinie beim Erstellen einer Instanzvorlage festlegen möchten, senden Sie eine POST-Anfrage an eine der folgenden Methoden:

Geben Sie im Anfragetext im Feld scheduling eines oder mehrere der folgenden Felder an:

  • Fügen Sie das Feld onHostMaintenance ein, um das Verhalten bei der Hostwartung festzulegen.

  • Führen Sie einen der folgenden Schritte aus, um das Verhalten beim automatischen Neustart festzulegen:

    • Wenn die Instanz automatisch neu gestartet werden soll, fügen Sie das Feld automaticRestart ein.

    • Wenn Sie verhindern möchten, dass die Instanz automatisch neu gestartet wird, fügen Sie das Feld automaticRestart ein.

  • Wenn an Ihre Instanz lokale SSD-Laufwerke angehängt sind, fügen Sie das Feld localSsdRecoveryTimeout ein, um ein Zeitlimit für die Wiederherstellung von lokalen SSD-Daten festzulegen.

  • Wenn Sie ein Zeitlimit für Hostfehler festlegen möchten, fügen Sie das Feld hostErrorTimeoutSeconds ein.

Wenn Sie beispielsweise das Hostwartungsverhalten festlegen, die Instanz nach Hostfehlern oder geplanten Stopps automatisch neu starten, ein Zeitlimit für die Wiederherstellung lokaler SSD-Daten und ein Zeitlimit für Hostfehler festlegen möchten, stellen Sie eine Anfrage wie die folgende: Im folgenden Beispiel wird ebenfalls eine regionale Instanzvorlage erstellt.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "automaticRestart": AUTOMATIC_RESTART,
      "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
      "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, in dem die Instanzvorlage erstellt werden soll.

  • REGION: Region, in der die Instanzvorlage erstellt werden soll.

  • INSTANCE_TEMPLATE_NAME ist der Name der Instanzvorlage.

  • IMAGE_PROJECT: das Image-Projekt, das das Image enthält, z. B. debian-cloud. Weitere Informationen zu den unterstützten Image-Projekten finden Sie unter Öffentliche Images.

  • IMAGE: Wählen Sie eine der folgenden Optionen aus:

    • Eine bestimmte Version des Betriebssystem-Images; Beispiel: debian-12-bookworm-v20240617.

    • Eine Image-Familie, die als family/IMAGE_FAMILY formatiert sein muss. Diese gibt das neueste nicht verworfene Betriebssystem-Image an. Beispiel: Wenn Sie family/debian-12 angeben, wird die aktuelle Version in der Debian 12-Image-Familie verwendet. Weitere Informationen zur Verwendung von Image-Familien finden Sie unter Best Practices für Image-Familien.

  • MACHINE_TYPE ist der zu verwendende Maschinentyp.

  • AUTOMATIC_RESTART: Das Verhalten beim automatischen Neustart der Instanz, wenn sie abstürzt oder von Compute Engine für einen geplanten Stopp beendet wird. Geben Sie einen der folgenden Werte an:

    • So lassen Sie Ihre Instanz automatisch von Compute Engine neu starten: true

    • So verhindern Sie automatische Neustarts: false

  • ERROR_DETECTION_TIMEOUT: Die Anzahl der Sekunden, bevor eine nicht reagierende Instanz neu gestartet wird. Der Wert muss zwischen 90 (90 Sekunden) und 330 (330 Sekunden oder 5 Minuten und 30 Sekunden) liegen. Es sind nur 30-Sekunden-Schritte zulässig.

  • LOCAL_SSD_RECOVERY_TIMEOUT: Anzahl der Stunden, die für die Wiederherstellung von Daten von den angehängten lokalen SSD-Laufwerken benötigt werden. Der Wert muss zwischen 0 (0 Stunden) und 168 (168 Stunden oder 7 Tage) liegen. Wenn Sie dieses Feld auf 0 setzen, stellt Compute Engine keine lokalen SSD-Daten wieder her.

  • MAINTENANCE_POLICY: Das Wartungsverhalten der Instanzen. Der Wert kann TERMINATE oder MIGRATE sein. Wenn Sie in der Instanzvorlage eine Spot-VM, eine VM auf Abruf oder einen Instanztyp angeben, der keine Live-Migration unterstützt, können Sie nur TERMINATE verwenden.

Weitere Informationen zum Erstellen einer Instanzvorlage finden Sie unter Instanzvorlagen erstellen.

Hostwartungsrichtlinie einer Instanz ansehen

Sie können die Hostwartungsrichtlinie einer Instanz in den Instanzdetails einsehen.

Wenn Sie die Details der Instanz mit der gcloud CLI oder der REST API aufrufen, können Sie die Felder localSsdRecoveryTimeout und hostErrorTimeoutSeconds nur sehen, wenn Sie sie beim Erstellen oder Aktualisieren der Instanz angegeben haben.

Wenn Sie das Zeitlimit für die Wiederherstellung von Daten auf lokalen SSDs in einer Instanz mit angehängten lokalen SSD-Laufwerken aufrufen möchten, verwenden Sie die gcloud CLI oder die REST API. Wählen Sie andernfalls eine der folgenden Optionen aus:

Console

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf:

    Zu „VM-Instanzen“

  2. Klicken Sie in der Spalte Name auf die Instanz, die Sie aufrufen möchten. Eine Seite mit den Details der Instanz wird angezeigt.

  3. Auf dem Tab Details können Sie im Bereich Verwaltung im Abschnitt Verfügbarkeitsrichtlinien Folgendes sehen:

    • Im Feld Bei Hostwartung sehen Sie die Ereignisse zum Verhalten der Instanz bei Hostwartung.

    • Im Feld Zeitlimit für Hostfehler sehen Sie, wie lange die Instanz wartet, bevor sie neu gestartet oder beendet wird, nachdem erkannt wurde, dass sie nicht mehr reagiert. Wenn der Wert nicht festgelegt ist (), beträgt die Standardwartezeit 5 Minuten und 30 Sekunden.

    • Im Feld Automatischer Neustart sehen Sie, ob die Instanz automatisch neu gestartet wird, nachdem sie abgestürzt ist oder von Compute Engine für einen geplanten Stopp beendet wurde.

gcloud

Verwenden Sie den Befehl gcloud compute instances describe, wobei das Flag --flatten auf scheduling gesetzt ist, um die Richtlinie für die Hostwartung für eine Instanz aufzurufen:

 gcloud compute instances describe INSTANCE_NAME \
    --flatten=scheduling \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name der Instanz.

  • ZONE: die Zone, in der sich die Instanz befindet.

Die Ausgabe sieht etwa so aus:

---
scheduling:
  automaticRestart: true
  hostErrorTimeoutSeconds: 120
  localSsdRecoveryTimeout:
    nanos: 0
    seconds: '10800'
  onHostMaintenance: MIGRATE
  preemptible: false
  provisioningModel: STANDARD

REST

Stellen Sie eine GET-Anfrage an die Methode instances.get, um die Hostwartungsrichtlinie für eine Instanz aufzurufen. Fügen Sie in der Anfrage-URL den Abfrageparameter fields ein und legen Sie ihn auf scheduling fest:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?fields=scheduling

Ersetzen Sie Folgendes:

  • PROJECT_ID: Das Projekt, in dem die Instanz vorhanden ist.

  • ZONE: Die Zone, in der sich die Instanz befindet.

  • INSTANCE_NAME: der Name der Instanz.

Die Ausgabe sieht etwa so aus:

{
  "scheduling": {
    "onHostMaintenance": "MIGRATE",
    "automaticRestart": true,
    "preemptible": false,
    "provisioningModel": "STANDARD",
    "localSsdRecoveryTimeout": {
      "seconds": "10800",
      "nanos": 0
    }
  }
}

Nächste Schritte