Hostereignisse für mehrere Reservierungen verwalten

In diesem Dokument wird erläutert, wie Sie die Hostwartungsfunktionen 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. Informationen zum Verwalten der Wartung auf Ihren VM-Instanzen finden Sie unter 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 können Sie Unterbrechungen 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. Zum Ausführen von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei der Compute Engine authentifizieren:

    Wählen Sie den Tab für die gewünschte 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 für das 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. Richten Sie Benachrichtigungen ein. Erstellen Sie logbasierte Benachrichtigungen, 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 die Wartung für Ihre Reservierungen oder Reservierungsblöcke ansehen und bei Bedarf manuell starten. So können Sie die Ausfallsicherheit Ihrer Arbeitslasten gegenüber Hostfehlern erhöhen, Ausfallzeiten vermeiden und dafür 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 Umschalter 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 Wartungsarbeiten geplant sind:

          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 Wartungsarbeiten geplant sind:

          protoPayload.methodName="compute.reservations.block.upcomingGroupMaintenance" severity>=DEFAULT
          protoPayload.status.message =~ "scheduled"
          
        • So erhalten Sie Benachrichtigungen, wenn die Wartung begonnen hat:

          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 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 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 anstehenden Wartung für Ihre Reservierungen oder Reservierungsblöcke prüfen möchten, rufen Sie den Wartungsstatus auf.

    • 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üh Sie Benachrichtigungen erhalten möchten, wenn der Host einer VM nach einem Hostfehler oder einem fehlerhaften Hostbericht eine Notfallwartung oder ungeplante Wartung erfordert, verwalten Sie die Benachrichtigungen zur Notfallwartung der Hardware.

    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 für eine Reservierung das Feld upcomingGroupMaintenance fehlt, ist für die Reservierung oder den Reservierungsblock keine Wartung geplant. Weitere Informationen zu den Feldern in upcomingGroupMaintenance finden Sie unter Definitionen des Wartungsstatus.

    Wenn außerdem eine Wartung für einen Reservierungsblock geplant ist, enthält das Feld upcomingGroupMaintenance das Feld maintenanceReasons. In diesem Feld wird beschrieben, warum die Wartung für Ihren Reservierungsblock geplant wurde, wie in der folgenden Tabelle beschrieben:

    Wartungstyp Grund für die Wartung VM-Status
    Geplante Wartung für regelmäßige Wartung
    • PLANNED_UPDATE: geplante Infrastrukturwartung
    • PLANNED_NETWORK_UPDATE: geplante Netzwerkwartung
    Gilt für ausgeführte, beendete oder gesperrte VMs.
    Außerplanmäßige Notfallwartung
    • FAILURE_DISK: Ungeplante Wartung, die aufgrund eines Fehlers mit einem an eine VM angehängten Laufwerk geplant wurde.
    • FAILURE_INFRA: Ungeplante Wartung, die aufgrund eines Fehlers in der Infrastruktur geplant wurde.
    • FAILURE_INTERFACE: Ungeplante Wartung aufgrund eines Fehlers mit der NIC geplant.
    • FAILURE_MEMORY: Ungeplante Wartung, die aufgrund eines Fehlers im Arbeitsspeicher einer VM geplant wurde.
    • FAILURE_NETWORK: Ungeplante Wartung aufgrund eines Netzwerkfehlers geplant.
    Gilt nur für laufende 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 zeigt Compute Engine den Wartungsstatus Ihrer Reservierungen an. Wenn diese Spalte in der Tabelle On-Demand-Reservierungen nicht angezeigt wird, klicken Sie auf Spaltenanzeigeoptionen, setzen Sie ein Häkchen bei Wartungsstatus und klicken Sie dann 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 in der Spalte Wartung zeigt Compute Engine den Wartungsstatus der Blöcke innerhalb der Reservierung an.

    gcloud

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

      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 den Wartungsstatus der Blöcke in der Reservierung mit dem Befehl gcloud compute reservations blocks list 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 Suchparameter ein:

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

      • Wenn Sie nur nach Reservierungen filtern möchten, die einen bestimmten Maschinentyp angeben, fügen Sie den Suchparameter 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 die folgende:

      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 Abfrageparameter filter auf einen anderen Filterausdruck festlegen.

    2. Wenn für Ihre Reservierung eine Wartung geplant ist, stellen Sie eine GET-Anfrage an die Methode reservationBlocks.list, um den Wartungsstatus der Blöcke innerhalb der Reservierung aufzurufen. 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 Compute Engine hat eine Wartung für die Reservierung 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 innerhalb eines Reservierungsblocks 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 dann eine der folgenden Optionen aus:

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

      • Wenn Sie die Wartung nur für Blöcke mit laufenden VMs starten möchten, wählen Sie Verwendete Kapazität aus.

      • Wenn Sie die Wartung nur für nicht verwendete Blöcke und Blöcke mit beendeten oder gesperrten 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 gesperrten 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

      • So starten Sie die Wartung nur auf Hosts mit laufenden VMs: running

      • So starten Sie die Wartung nur auf ungenutzten Hosts und Hosts mit beendeten oder gesperrten 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

      • So starten Sie die Wartung nur auf Hosts mit laufenden VMs: RUNNING

      • So starten Sie die Wartung nur auf ungenutzten Hosts und Hosts mit beendeten oder gesperrten VMs: UNUSED

    Benachrichtigungen zu Notfallwartungen an Hardware verwalten

    Wenn auf 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 kündigt Compute Engine diese Art von Wartung einige Stunden im Voraus an. 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 zu Notfallwartungen 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 Benachrichtigungen zu Notfallwartungen 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 zu Notfallwartungen 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 Benachrichtigungen zu Notfallwartungen für eine Reservierung aktivieren oder deaktivieren möchten, senden 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 aktivieren Sie Benachrichtigungen: true

      • So deaktivieren Sie Benachrichtigungen: false

    Nächste Schritte