Host-Wartungsereignis manuell starten

Auf dieser Seite wird beschrieben, wie Sie auf unterstützten Compute Engine-Instanzen manuell ein Host-Wartungsereignis starten. Mit dieser Funktion können Sie ein Wartungsereignis starten, um den Zeitpunkt der Wartung Ihrer Instanz zu steuern. Dies ist für solche Arbeitslasten nützlich, auf die sich eine verminderte Leistung bzw. Ausfallzeiten möglicherweise auswirken und für die das Wartungsfenster zu einem bestimmten Zeitpunkt beginnen muss.

Wenn Sie ein Wartungsereignis manuell starten, beginnt die Hostwartung sofort. Sie können kein Datum oder keine Uhrzeit für den Beginn des Wartungsereignisses angeben. Wenn Sie diese Funktion nicht verwenden, findet das Wartungsereignis zu dem in der Benachrichtigung über die bevorstehende Wartungangegebenen Zeitpunkt statt.

Wenn Sie zuerst testen möchten, wie Ihre Anwendungen mit einem Wartungsereignis umgehen, können Sie ein Wartungsereignis simulieren.

Beschränkungen

Sie können ein Host-Wartungsereignis manuell für Instanzen starten, die die folgenden Maschinentypen verwenden:

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. Wenn Sie Code oder Beispiele aus einer lokalen Entwicklungsumgebung ausführen möchten, können Sie sich bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:

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

    gcloud

    1. Installieren Sie die Google Cloud CLI. Initialisieren Sie nach der Installation, initialisieren Sie die Google Cloud CLI 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 Google Cloud Authentifizierungsdokumentation unter Für die Verwendung von REST authentifizieren.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) für das Projekt zu gewähren, um die Berechtigungen zu erhalten, die Sie für die Verwaltung der VM-Wartung benötigen. 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 Verwalten der VM-Wartung erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen , um die notwendigen Berechtigungen anzuzeigen, die erforderlich sind:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind für die Verwaltung der VM-Wartung erforderlich:

  • Informationen zu einer Compute-Instanz abrufen: compute.instances.get

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

Host-Wartungsereignis manuell starten

Compute Engine sendet Benachrichtigungen für bevorstehende Wartungsereignisse auf verschiedene Arten. Anhand der Informationen in den Benachrichtigungen können Sie den Zeitraum bestimmen, in dem Sie ein Wartungsereignis manuell starten können.

Benachrichtigungsinformationen prüfen

Sie können Ihre Benachrichtigungen zu Wartungsereignissen auf eine der folgenden Arten finden:

Wenn die Benachrichtigung zu einem Host-Wartungsereignis canReschedule=True und maintenanceStatus=Pending enthält, können Sie die Wartung zu einem beliebigen Zeitpunkt starten oder warten, bis das Wartungsereignis zu dem unter windowStartTime angegebenen Zeitpunkt stattfindet.

Wenn keine Benachrichtigung vorhanden ist und Sie versuchen, ein Wartungsereignis manuell zu starten, wird die folgende Meldung angezeigt:

There is no reschedulable upcoming maintenance.

Diese Meldung gibt an, dass kein Wartungsereignis geplant wurde und keine Maßnahmen erforderlich sind.

Wartungsereignis starten

Sie können die Hostwartung zu einem beliebigen Zeitpunkt starten, anstatt auf den geplanten Zeitpunkt zu warten. Verwenden Sie die Google Cloud CLI oder REST, um das Wartungsereignis auszulösen, das dann sofort beginnt.

gcloud

Verwenden Sie den compute instances perform-maintenance Befehl, um ein Wartungsereignis zu starten. Die Hostwartung beginnt sofort nach Eingabe des Befehls.

gcloud compute instances perform-maintenance INSTANCE_NAME \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: Der Name der Compute-Instanz.
  • ZONE: Die Zone, in der sich die Instanz befindet.

Die Antwort ähnelt dem folgenden Beispiel.

resourceStatus:
  upcomingMaintenance:
    canReschedule: false
    latestWindowStartTime: '2025-01-15T19:57:17Z'
    maintenanceStatus: ONGOING
    type: SCHEDULED
    windowEndTime: '2025-01-15T23:57:11Z'
    windowStartTime: '2025-01-15T19:57:16Z'

In der Antwort ist canReschedule auf false und maintenanceStatus auf ONGOING gesetzt. Das bedeutet, dass die Hostwartung ausgeführt wird.

REST

Erstellen Sie eine POST Anfrage mit der instances.performMaintenance Methode, um ein Wartungsereignis zu starten.

POST: https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME/performMaintenance

Ersetzen Sie Folgendes:

  • PROJECT_NAME: Der Name des Projekts
  • ZONE: Die Zone, in der sich die Compute-Instanz befindet
  • INSTANCE_NAME: Der Name der Instanz

Die Antwort sieht so aus:

upcomingMaintenance:{
  "canReschedule":false
  "latestWindowStartTime": "2023-12-01T19:00:01Z"
  "maintenanceStatus":"ONGOING"
  "type":"SCHEDULED"
  "windowEndTime": "2023-12-01T22:00:00Z"
  "windowStartTime": "2023-12-01T19:00:00Z"
}

In der Antwort ist canReschedule auf false und maintenanceStatus auf ONGOING gesetzt. Das bedeutet, dass die Hostwartung ausgeführt wird.

Nächste Schritte