Hostereignisse für mehrere Reservierungen verwalten

In diesem Dokument wird erläutert, wie Sie die Funktionen für die Hostwartung verwenden, die für Ihre reservierten Kapazitätsblöcke verfügbar sind. Es wird erläutert, wie Sie geplante Wartungsarbeiten an Ihrem Cluster von H4D-Instanzen überwachen, planen und durchführen. Wenn Sie stattdessen die Wartung Ihrer VM-Instanzen verwalten möchten, lesen Sie den Abschnitt Hostwartungsereignis überwachen und planen.

Sie können anstehende Hostwartungsereignisse für Ihre reservierten Kapazitätsblöcke proaktiv verwalten, unabhängig davon, ob VMs darauf ausgeführt werden oder nicht. So lassen sich Störungen minimieren und eine optimale Leistung aufrechterhalten.

Hinweis

  • 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:

    Wählen Sie den Tab für die geplante Verwendung der Beispiele auf dieser Seite aus:

    Console

    Wenn Sie über die Google Cloud Console auf Dienste und APIs von Google Cloud zugreifen, müssen Sie die Authentifizierung nicht einrichten.

    gcloud

    1. Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl: 

      gcloud init

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  • Legen Sie eine Standardregion und -zone fest.

    • REST

    Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

      Installieren Sie die Google Cloud CLI.

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

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

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Verwalten von Hostwartungsereignissen für Reservierungen benötigen:

  • Compute-Administrator (roles/compute.admin) für das Projekt
  • Für Lesezugriff auf Audit-Logs zu Systemereignissen: Loganzeige (roles/logging.viewer) für das Projekt

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Verwalten von Hostwartungsereignissen für Reservierungen erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Hostwartungsereignisse für mehrere Reservierungen zu verwalten:

  • So starten Sie die Hostwartung für eine Reservierung: compute.reservations.performMaintenance im Projekt
  • So starten Sie die Hostwartung für einen Reservierungsblock: compute.reservationBlocks.performMaintenance für das Projekt

    • So rufen Sie eine Liste der Reservierungen auf:

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

    Übersicht

    So optimieren Sie die Wartung Ihrer reservierten Kapazitätsblöcke:

    1. Benachrichtigungen einrichten Sie können logbasierte Benachrichtigungen erstellen, um über geplante, gestartete oder abgeschlossene Wartungsereignisse für eine Reservierung oder einen Reservierungsblock informiert zu werden. So können Sie Ihre Aktivitäten proaktiv planen und unerwartete Ausfallzeiten vermeiden.

    2. Wartung für Kapazitätsblöcke verwalten Sie können sich die Wartung für Ihre Reservierungen oder Reservierungsblöcke ansehen und sie bei Bedarf manuell starten. Dieser Prozess hilft Ihnen, die Ausfallsicherheit Ihrer Arbeitslasten gegenüber Hostfehlern zu erhöhen, Ausfallzeiten zu vermeiden und dafür zu sorgen, dass Ihre Anwendungen verfügbar bleiben.

    Weitere Informationen zur Häufigkeit und zum Wartungsverhalten von H4D-Maschinentypen finden Sie unter Wartung für H4D-Instanzen.

    Benachrichtigungen für Reservierungen einrichten

    Sie können sich über geplante, gestartete oder abgeschlossene Wartungsereignisse für eine Reservierung oder einen Reservierungsblock benachrichtigen lassen, indem Sie logbasierte Benachrichtigungsrichtlinien erstellen.

    So erstellen Sie eine Benachrichtigung für die Wartungsereignisse einer Reservierung oder eines Reservierungsblocks: Wiederholen Sie diesen Vorgang für jede Benachrichtigung, die Sie erstellen möchten.

    1. Rufen Sie in der Google Cloud Console das und die Seite Log-Explorer auf:

      Zum Log-Explorer

      Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis mit der Zwischenüberschrift Logging aus.

    2. Klicken Sie auf den Ein/Aus-Button Abfrage anzeigen, um die Option zu aktivieren.

    3. Erstellen Sie im Bereich Abfrage eine der folgenden Abfragen. Mit diesen Abfragen werden Logeinträge gefiltert, um bestimmte Wartungsereignisse zu identifizieren. Wiederholen Sie diesen Vorgang für jede Abfrage, die Sie erstellen möchten.

      • Wartungsbenachrichtigungen für eine Reservierung erhalten:

        • So erhalten Sie Benachrichtigungen, wenn eine Wartung geplant ist:

          protoPayload.methodName="compute.reservations.upcomingGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "scheduled"

        • So erhalten Sie Benachrichtigungen, wenn die Wartung abgeschlossen ist:

          protoPayload.methodName="compute.reservations.completedGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "completed"

      • Wartungsbenachrichtigungen für einen Reservierungsblock erhalten:

        • So erhalten Sie Benachrichtigungen, wenn eine Wartung geplant ist:

          protoPayload.methodName="compute.reservations.block.upcomingGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "scheduled"

        • So erhalten Sie Benachrichtigungen, wenn Wartungsarbeiten begonnen haben:

          protoPayload.methodName="compute.reservations.block.startGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "started"

        • So erhalten Sie Benachrichtigungen, wenn die Wartung abgeschlossen ist:

          protoPayload.methodName="compute.reservations.block.completedGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "completed"

    4. Klicken Sie auf Abfrage ausführen, um die Abfrage zu validieren. Wenn die Abfrage gültig ist, werden im Bereich Abfrageergebnisse Logeinträge angezeigt, die mit der Abfrage übereinstimmen.

    5. Klicken Sie in der Symbolleiste für Abfrageergebnisse auf die Liste Aktionen und wählen Sie dann Logbenachrichtigung erstellen aus. Der Bereich Logbasierte Benachrichtigungsrichtlinie erstellen wird angezeigt.

    6. Geben Sie im Abschnitt Benachrichtigungsdetails Folgendes an:

      1. Geben Sie im Feld Name der Benachrichtigungsrichtlinie einen Namen für die Richtlinie ein.

      2. Wählen Sie in der Liste Schweregrad der Richtlinie die Option Warnung (oder einen höheren Schweregrad) aus.

      3. Klicken Sie auf Weiter.

    7. Klicken Sie im Bereich Logs auswählen, die in die Benachrichtigung aufgenommen werden sollen auf Weiter.

    8. Geben Sie im Abschnitt Benachrichtigungshäufigkeit und Dauer für automatisches Schließen festlegen Folgendes an:

      1. Wählen Sie in der Liste Zeit zwischen Benachrichtigungen aus, wie oft Sie benachrichtigt werden möchten.

      2. Wählen Sie in der Liste Dauer bis zur automatischen Schließung von Vorfällen aus, nach welcher Zeit Cloud Logging keine Benachrichtigungen mehr sendet und den Vorfall automatisch schließt.

      3. Klicken Sie auf Weiter.

    9. Geben Sie im Abschnitt Wer soll benachrichtigt werden? einen Benachrichtigungskanal für Logging an, an den Benachrichtigungen gesendet werden sollen.

    10. Klicken Sie auf Speichern.

    Wartung für mehrere Reservierungen verwalten

    So können Sie die Wartung für Ihre Reservierungen und Reservierungsblöcke aufrufen und steuern:

    • Wenn Sie den Status und die geplante Zeit der bevorstehenden Wartung für Ihre Reservierungen oder Reservierungsblöcke prüfen möchten, sehen Sie sich den Wartungsstatus an.

    • Wenn Sie die Wartung für eine Reservierung oder einen Reservierungsblock manuell starten möchten, anstatt auf das geplante Wartungsdatum und die geplante Wartungszeit zu warten, starten Sie die Wartung manuell.

    • Wenn Sie festlegen möchten, wie frühzeitig Sie Benachrichtigungen erhalten, wenn der Host einer VM nach einem Hostfehler oder einem fehlerhaften Hostbericht eine ungeplante Notfallwartung benötigt, verwalten Sie Benachrichtigungen zur Hardware-Notfallwartung.

    Wartungsstatus ansehen

    Sie können den Status der anstehenden Wartung für eine Reservierung oder einen Reservierungsblock prüfen, indem Sie den Wert des Felds upcomingGroupMaintenance in den Reservierungsmetadaten prüfen. Wenn in einer Reservierung das Feld upcomingGroupMaintenance fehlt, ist keine Wartung für die Reservierung oder den Reservierungsblock geplant. Weitere Informationen zu den Feldern in upcomingGroupMaintenance finden Sie unter Definitionen des Wartungsstatus.

    Wenn außerdem Wartungsarbeiten für einen Reservierungsblock geplant sind, enthält das Feld upcomingGroupMaintenance das Feld maintenanceReasons. In diesem Feld wird beschrieben, warum Wartungsarbeiten für Ihren Reservierungsblock geplant wurden. Die möglichen Werte sind in der folgenden Tabelle aufgeführt:

    Wartungstyp Wartungsgrund VM-Status
    Geplante Wartung für die regelmäßige Wartung
    • PLANNED_UPDATE: geplante Wartung der Infrastruktur
    • PLANNED_NETWORK_UPDATE: geplante Netzwerkwartung
    		 Gilt für ausgeführte, beendete oder angehaltene VMs.
    Außerplanmäßige Notfallwartung
    • FAILURE_DISK: Ungeplante Wartung, die aufgrund eines Fehlers bei einem an eine VM angehängten Laufwerk geplant wurde.
    • FAILURE_INFRA: Außerplanmäßige Wartung, die aufgrund eines Fehlers in der Infrastruktur geplant wurde.
    • FAILURE_INTERFACE: Außerplanmäßige Wartung aufgrund eines Fehlers mit der NIC.
    • FAILURE_MEMORY: ungeplante Wartung aufgrund eines Fehlers im Arbeitsspeicher einer VM.
    • FAILURE_NETWORK: Ungeplante Wartung aufgrund eines Netzwerkfehlers geplant.
    		 Gilt nur für ausgeführte VMs.

    Wenn Sie das Feld maintenanceReasons in einem Reservierungsblock oder Unterblock aufrufen möchten, müssen Sie die gcloud CLI oder die REST API verwenden. Wählen Sie anderenfalls eine der folgenden Optionen aus:

    Console

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

      Zu „Reservierungen“

    2. In der Spalte Wartungsstatus wird von Compute Engine der Wartungsstatus Ihrer Reservierungen angezeigt. Wenn diese Spalte in der Tabelle On-Demand-Reservierungen nicht angezeigt wird, klicken Sie auf  Spaltenanzeigeoptionen, aktivieren Sie das Kästchen Wartungsstatus und klicken Sie auf OK.

    3. So rufen Sie den Wartungsstatus eines Reservierungsblocks auf:

      1. Klicken Sie in der Spalte Name auf den Namen der Reservierung. Eine Seite mit den Details der Reservierung wird angezeigt.

      2. In der Tabelle Blöcke wird in der Spalte Wartung von Compute Engine der Wartungsstatus der Blöcke in der Reservierung angezeigt.

    gcloud

    1. Verwenden Sie zum Aufrufen des Wartungsstatus einer Reservierung den Befehl gcloud compute reservations describe, wobei das Flag --flatten auf resourceStatus.reservationMaintenance gesetzt ist:

      gcloud compute reservations describe RESERVATION_NAME \
    --flatten=resourceStatus.reservationMaintenance \
    --zone=ZONE

      Ersetzen Sie Folgendes:

      • RESERVATION_NAME: der Name der Reservierung.

      • ZONE: die Zone, in der die Reservierung vorhanden ist.

      Die Ausgabe sieht in etwa so aus:

      • Wenn für Ihre Reservierung eine Wartung geplant ist, sieht die Ausgabe in etwa so aus:

        ---
maintenanceOngoingCount: 0
maintenancePendingCount: 6
schedulingType: GROUPED
upcomingGroupMaintenance:
  canReschedule: true
  maintenanceStatus: PENDING
  type: UNSCHEDULED
  windowEndTime: '2025-11-13T14:00:00.000-08:00'
  windowStartTime: '2025-11-13T12:00:00.000-08:00'

        Wenn das Feld schedulingType auf INDEPENDENT gesetzt ist, enthält das Feld upcomingGroupMaintenance nicht die Felder windowStartTime und windowEndTime.

      • Wenn für Ihre Reservierung keine Wartung geplant ist, sieht die Ausgabe in etwa so aus:

        ---
schedulingType: GROUPED

    2. Wenn für Ihre Reservierung Wartungsarbeiten geplant sind, können Sie mit dem Befehl gcloud compute reservations blocks list den Wartungsstatus der Blöcke in der Reservierung aufrufen:

      gcloud compute reservations blocks list RESERVATION_NAME \
    --zone=ZONE

      Wenn für einen Reservierungsblock eine Wartung geplant ist oder gerade durchgeführt wird, sieht die Ausgabe in etwa so aus:

      ---
...
name: example-fr-h4d-dense-1-block-0001
...
reservationBlockMaintenance:
  maintenanceOngoingCount: 0
  maintenancePendingCount: 6
  schedulingType: GROUPED
  upcomingGroupMaintenance:
    canReschedule: true
    maintenanceReasons:
    - PLANNED_UPDATE
    - PLANNED_NETWORK_UPDATE
    maintenanceStatus: PENDING
    type: UNSCHEDULED
    windowEndTime: '2025-11-13T14:00:00.000-08:00'
    windowStartTime: '2025-11-13T12:00:00.000-08:00'
...
---
...
name: example-fr-h4d-dense-1-block-0002
...
schedulingType: GROUPED
...

    REST

    1. Wenn Sie den Wartungsstatus Ihrer Reservierungen aufrufen möchten, stellen Sie eine GET-Anfrage an eine der folgenden Methoden:

      Fügen Sie in der Anfrage-URL die folgenden Abfrageparameter ein:

      • Wenn Sie nur den Namen, den reservierten Maschinentyp und den Wartungsstatus einer Reservierung sehen möchten, fügen Sie den Abfrageparameter fields mit dem Wert items.name,items.specificReservation.instanceProperties.machineType,items.resourceStatus.reservationMaintenance ein.

      • Wenn Sie nur nach Reservierungen filtern möchten, für die ein bestimmter Maschinentyp angegeben ist, fügen Sie den Abfrageparameter filter mit dem Wert specificReservation.instanceProperties.machineType:MACHINE_TYPE hinzu. Verwenden Sie dazu URL-codierte Werte.

      Wenn Sie beispielsweise Reservierungen in allen Zonen aufrufen möchten, stellen Sie eine GET-Anfrage wie folgt:

      GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/reservations?fields=items.name,items.specificReservation.instanceProperties.machineType,items.resourceStatus.reservationMaintenance&filter=specificReservation.instanceProperties.machineType%3AMACHINE_TYPE

      Ersetzen Sie Folgendes:

      • PROJECT_ID: die ID des Projekts, in dem die Reservierungen vorhanden sind.

      • MACHINE_TYPE: der reservierte Maschinentyp, nach dem Sie Ihre Reservierungen filtern möchten.

      Wenn für eine Reservierung eine Wartung geplant ist oder gerade durchgeführt wird, sieht die Ausgabe in etwa so aus:

      {
  "items": [
    {
      "specificReservation": {
        "instanceProperties": {
          "machineType": "MACHINE_TYPE"
        }
      },
      "name": "example-reservation",
      "resourceStatus": {
        "reservationMaintenance": {
          maintenanceOngoingCount: 0,
          maintenancePendingCount: 6,
          "schedulingType": "GROUPED",
          "upcomingGroupMaintenance": {
            "type": "SCHEDULED",
            "canReschedule": true,
            "windowStartTime": "2025-11-13T12:00:00.000-08:00",
            "windowEndTime": "2025-11-13T14:00:00.000-08:00",
            "maintenanceStatus": "PENDING"
          }
        }
      }
    },
    ...
  ]
}

      Optional können Sie die Liste der VMs weiter eingrenzen, indem Sie den filter-Abfrageparameter auf einen anderen Filterausdruck festlegen.

    2. Wenn für Ihre Reservierung Wartungsarbeiten geplant sind, können Sie den Wartungsstatus der Blöcke in der Reservierung mit einer GET-Anfrage an die Methode reservationBlocks.list aufrufen. Fügen Sie in der Anfrage-URL den Abfrageparameter fields ein, wobei dieser auf items.name,items.reservationMaintenance gesetzt ist:

      GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks?fields=items.name,items.reservationMaintenance

      Ersetzen Sie RESERVATION_NAME durch den Namen der Reservierung.

      Wenn für einen Reservierungsblock eine Wartung geplant ist oder gerade durchgeführt wird, sieht die Ausgabe in etwa so aus:

      {
  "items": [
    {
      "name": "example-fr-h4d-dense-1-block-0001",
      "reservationBlockMaintenance": {
        "maintenanceOngoingCount": 0,
        "maintenancePendingCount": 6,
        "schedulingType": "GROUPED",
        "upcomingGroupMaintenance": {
          "type": "SCHEDULED",
          "canReschedule": true,
          "windowStartTime": "2025-11-13T12:00:00.000-08:00",
          "windowEndTime": "2025-11-13T14:00:00.000-08:00",
          "maintenanceStatus": "PENDING",
          "maintenanceReasons": [
            "PLANNED_UPDATE",
            "PLANNED_NETWORK_UPDATE"
          ]
        }
      }
    },
    ...
  ]
}

      Wenn das Feld schedulingType für einen Block auf INDEPENDENT gesetzt ist, enthält das Feld upcomingGroupMaintenance nicht die Felder windowStartTime und windowEndTime.

    Wartung manuell starten

    Sie können die Wartung für Ihre Reservierungen oder Reservierungsblöcke manuell starten, anstatt auf den geplanten Zeitpunkt zu warten. So können Sie Unterbrechungen Ihrer Arbeitslasten proaktiver kontrollieren.

    Je nach Wartungsstatus einer Reservierung oder eines Reservierungsblocks geschieht Folgendes:

    Wartungsstatus Beschreibung Was wird angezeigt?
    Geplant Für die Reservierung ist eine Compute Engine-Wartung geplant. Sie können die Wartung vor dem geplanten Zeitpunkt manuell starten.
    • In der Google Cloud Console wird der Wartungsstatus als Bereit zur Ausführung – wird am DATE ausgeführt angezeigt.
    • In der gcloud CLI oder REST API setzt Compute Engine das Feld maintenanceStatus auf PENDING.
    In Bearbeitung Die Wartung läuft. Sie können ihn nicht verschieben.
    • In der Google Cloud Console wird der Wartungsstatus als Wird ausgeführt angezeigt.
    • In der gcloud CLI oder REST API setzt Compute Engine das Feld maintenanceStatus auf ONGOING.
    Abgeschlossen Die Wartung ist abgeschlossen. Compute Engine hat alle Wartungsbenachrichtigungen von der VM entfernt.
    • In der Google Cloud Console wird der Wartungsstatus als – angezeigt.
    • In der gcloud CLI oder REST API ist das Feld maintenanceStatus nicht vorhanden.

    Wenn Sie die Wartung auf bestimmten Hosts in einem Reservierungsblock manuell starten möchten, verwenden Sie die gcloud CLI oder die REST API. Wählen Sie anderenfalls eine der folgenden Optionen aus:

    Console

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

      Zu „Reservierungen“

    2. Klicken Sie in der Spalte Name auf den Namen einer Reservierung. Eine Seite mit den Details der Reservierung wird angezeigt.

    3. Klicken Sie auf Wartung ausführen und wählen Sie eine der folgenden Optionen aus:

      • Wenn Sie die Wartung für alle Blöcke starten möchten, wählen Sie Alle Kapazitäten aus.

      • Wenn Sie die Wartung nur für Blöcke mit laufenden VMs starten möchten, wählen Sie In-use capacity (Kapazität in Verwendung) aus.

      • Wenn Sie die Wartung nur für nicht verwendete Blöcke und Blöcke mit beendeten oder ausgesetzten VMs starten möchten, wählen Sie Nicht verwendete Kapazität aus.

    4. Klicken Sie zur Bestätigung auf Ok.

    gcloud

    • Verwenden Sie den Befehl gcloud compute reservations perform-maintenance, um die Wartung für eine Reservierung zu starten:

      gcloud compute reservations perform-maintenance RESERVATION_NAME \
    --scope=RESERVATION_MAINTENANCE_SCOPE \
    --zone=ZONE

    • Verwenden Sie den Befehl gcloud compute reservations blocks perform-maintenance, um die Wartung für einen Reservierungsblock zu starten:

      gcloud compute reservations blocks perform-maintenance RESERVATION_NAME \
    --block-name=BLOCK_NAME \
    --scope=BLOCK_MAINTENANCE_SCOPE \
    --zone=ZONE

      Ersetzen Sie Folgendes:

    • RESERVATION_NAME: der Name der Reservierung.

    • RESERVATION_MAINTENANCE_SCOPE: Der Wartungsumfang für die Reservierung. Geben Sie einen der folgenden Werte an:

      • So starten Sie die Wartung für alle Blöcke: all

      • So starten Sie die Wartung nur für Blöcke mit laufenden VMs: running

      • So starten Sie die Wartung nur für nicht verwendete Blöcke und Blöcke mit beendeten oder ausgesetzten VMs: unused

    • BLOCK_NAME: der Name eines Blocks, der in der Reservierung vorhanden ist.

    • BLOCK_MAINTENANCE_SCOPE: der Wartungsumfang für den Reservierungsblock. Geben Sie einen der folgenden Werte an:

      • So starten Sie die Wartung auf allen Hosts: all

      • Wartung nur auf Hosts mit laufenden VMs starten: running

      • So starten Sie die Wartung nur auf nicht verwendeten Hosts und Hosts mit beendeten oder ausgesetzten VMs: unused

    • ZONE: die Zone, in der die Reservierung vorhanden ist.

    REST

    • Wenn Sie die Wartung für eine Reservierung starten möchten, senden Sie eine POST-Anfrage an die Methode reservations.performMaintenance:

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/performMaintenance

{
  "maintenanceScope": "RESERVATION_MAINTENANCE_SCOPE"
}

    • Senden Sie eine POST-Anfrage an die Methode reservationBlocks.performMaintenance, um die Wartung für einen Reservierungsblock zu starten:

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/performMaintenance

{
  "maintenanceScope": "BLOCK_MAINTENANCE_SCOPE"
}

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die ID des Projekts, in dem die Compute Engine die Reservierung automatisch erstellt hat.

    • ZONE: die Zone, in der die Reservierung vorhanden ist.

    • RESERVATION_NAME: der Name der Reservierung.

    • RESERVATION_MAINTENANCE_SCOPE: Der Wartungsumfang für die Reservierung. Geben Sie einen der folgenden Werte an:

      • So starten Sie die Wartung für alle Blöcke: ALL

      • So starten Sie die Wartung nur für Blöcke mit laufenden VMs: RUNNING

      • So starten Sie die Wartung nur für nicht verwendete Blöcke und Blöcke mit beendeten oder gesperrten VMs: UNUSED

    • BLOCK_NAME: der Name eines Blocks, der in der Reservierung vorhanden ist.

    • SUB_BLOCK_NAME: der Name eines Unterblocks, der im Reservierungsblock vorhanden ist.

    • BLOCK_MAINTENANCE_SCOPE: der Wartungsumfang für den Reservierungsblock. Geben Sie einen der folgenden Werte an:

      • So starten Sie die Wartung auf allen Hosts: ALL

      • Wartung nur auf Hosts mit laufenden VMs starten: RUNNING

      • So starten Sie die Wartung nur auf nicht verwendeten Hosts und Hosts mit beendeten oder ausgesetzten VMs: UNUSED

    Benachrichtigungen zur Notfallwartung von Hardware verwalten

    Wenn bei einer VM ein Hostfehler auftritt oder Sie den Host als fehlerhaft melden, ist für den Host der VM eine ungeplante Notfallwartung erforderlich. Standardmäßig werden Sie in Compute Engine einige Stunden im Voraus benachrichtigt, wenn diese Art von Wartung geplant ist. Für reservierte Hosts können Sie Benachrichtigungen zu Notfallwartungen aktivieren, um diese Benachrichtigungsfrist auf mindestens sieben Tage zu verlängern. Mit diesem Ansatz können Sie Unterbrechungen Ihrer Arbeitslasten proaktiver kontrollieren.

    Wählen Sie eine der folgenden Optionen aus, um Benachrichtigungen zur Notfallwartung von Hardware für eine Reservierung zu aktivieren oder zu deaktivieren:

    gcloud

    • Verwenden Sie den Befehl gcloud compute reservations update mit dem Flag --enable-emergent-maintenance, um Hardware-Notfallwartungsbenachrichtigungen für eine Reservierung zu aktivieren:

      gcloud compute reservations update RESERVATION_NAME \
    --enable-emergent-maintenance \
    --zone=ZONE

    • Verwenden Sie den Befehl gcloud compute reservations update mit dem Flag --no-enable-emergent-maintenance, um Benachrichtigungen zur Notfallwartung der Hardware für eine Reservierung zu deaktivieren:

      gcloud compute reservations update RESERVATION_NAME \
    --no-enable-emergent-maintenance \
    --zone=ZONE

    Ersetzen Sie Folgendes:

    • RESERVATION_NAME: der Name der Reservierung.

    • ZONE: die Zone, in der die Reservierung vorhanden ist.

    REST

    Wenn Sie Hardware-Notfallwartungsbenachrichtigungen für eine Reservierung aktivieren oder deaktivieren möchten, stellen Sie eine PATCH-Anfrage an die Methode reservations.update. Fügen Sie in der Anfrage-URL den Abfrageparameter paths ein, wobei dieser auf enableEmergentMaintenance gesetzt ist.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=enableEmergentMaintenance

{
  "name": "RESERVATION_NAME",
  "enableEmergentMaintenance": EMERGENCY_MAINTENANCE_NOTIFICATIONS
}

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die ID des Projekts, in dem die Reservierung vorhanden ist.

    • ZONE: die Zone, in der die Reservierung vorhanden ist.

    • RESERVATION_NAME: der Name der Reservierung.

    • EMERGENCY_MAINTENANCE_NOTIFICATIONS: Geben Sie einen der folgenden Werte an:

      • So aktivierst du Benachrichtigungen: true

      • So deaktivieren Sie Benachrichtigungen: false

    Nächste Schritte