Auf dieser Seite wird erläutert, wie Sie ein Host-Wartungsereignis für bestimmte VM-Familieninstanzen auslösen. Mit diesem Feature können Sie manuell ein Wartungsereignis starten, um den Wartungszeitpunkt Ihrer VM zu steuern. Dies ist für Arbeitslasten nützlich, die möglicherweise von einem bestimmten Wartungsfenster betroffen sein können.
Sie können ein Wartungsereignis manuell auslösen, das sofort beginnt. Es ist nicht möglich, ein Ereignis zu einem bestimmten Datum oder einer bestimmten Uhrzeit auszulösen. Wenn Sie dieses Feature nicht verwenden, erfolgt das Wartungsereignis wie geplant.
Beschränkungen
Das Auslösen eines VM-Host-Wartungsereignisses ist auf die folgenden VM-Maschinentypen beschränkt:
- Sämtliche Host-C4-Standardmaschinen mit großem Speicher und hoher CPU-Leistung (Vorschau) mit 192 vCPUs
- Sämtliche Host-C3-Standardmaschinen mit großem Speicher und hoher CPU-Leistung mit 176 vCPUs
- C3-VMs mit lokaler SSD
- Sämtliche Host-C3D-Standardmaschinen mit großem Speicher hoher CPU-Leistung mit 360 vCPUs
- C3D-VMs mit lokaler SSD
- Z3-Maschinen mit großem Speicher mit 176 vCPUs
Wenn Sie VMs aus anderen Maschinenfamilien verwenden, lesen Sie das Dokument Host-Wartungsrichtlinie festlegen.
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.
Select the tab for how you plan to use the samples on this page:
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
Um Informationen zu einer VM abzurufen:
compute.instances.get
-
Um eine VM zu erstellen:
compute.instances.create
VM_NAME
: Der Name der VM.ZONE
: Die Zone, in der sich die VM befindet.PROJECT_NAME
ist der Name des Projekts.ZONE
: Die Zone, in der sich die VM befindet.VM_NAME
: der Name der VM- windowStartTime: der Beginn des Zeitfensters, in dem die Wartung durchgeführt wird
- windowEndTime: das Ende des Zeitfensters, in dem die Wartung durchgeführt wird
- latestWindowStartTime: der früheste Zeitpunkt, zu dem das Fenster verschoben werden kann
- maintenanceType: der Typ der auszuführenden Wartung
- NONE: für diese VM ist keine Wartung geplant
- SCHEDULED: die Wartung wird 7 Tage im Voraus angekündigt
- UNSCHEDULED: die Wartung stellt kritische Aktualisierungen dar, für die wesentlich weniger Vorankündigungen ausgegeben werden.
- canReschedule: gibt an, ob die Wartung während des Benachrichtigungszeitraums für diese VM ausgelöst werden kann
- TRUE: eine vom Kunden ausgelöste Wartung kann während des Benachrichtigungszeitraums ausgeführt werden
- FALSE: eine vom Kunden ausgelöste Wartung kann für diese VM nicht ausgeführt werden. Dies tritt häufig in dem Zeitraum auf, in dem die VM gewartet wird
- maintenanceStatus: der Status des aktuellen Wartungsvorgangs
- ONGOING: der Wartungsvorgang wird ausgeführt
- PENDING: der Wartungsvorgang ist geplant, wurde aber noch nicht gestartet
- Bei
canReschedule=Yes
undmaintenanceStatus=Pending
können Sie die Wartung auf der VM auslösen. - Bei
canReschedule=No
undmaintenanceStatus=Ongoing
wird die Wartung bereits ausgeführt. - Bei
canReschedule=No
undmaintenanceStatus=Pending
unterstützt Ihre VM keine manuell ausgelöste Wartung. - Host-Wartungsereignis simulieren
- Live-Migrationshinweise abrufen
- Logbasierte Benachrichtigungen in Cloud Logging erstellen
REST
Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-Instanzadministrator (v1) (
roles/compute.instanceAdmin.v1
) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen von VMs und zum Verwalten der VM-Wartung benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen von VMs und zum Verwalten der VM-Wartung erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um VMs zu erstellen und die VM-Wartung zu verwalten:
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Host-Wartungsereignis auslösen
Google sendet Benachrichtigungen über bevorstehende VM-Wartungen durch mehrere Methoden. Sie finden Ihre Benachrichtigungen durch Abfrage Ihrer VMs, des Metadatenservers oder von Cloud Logging.
Nachdem Sie eine Benachrichtigung zu einem Host-Wartungsereignis erhalten haben, können Sie die Wartung sofort auslösen oder warten, bis das Wartungsereignis wie geplant stattfindet.
Wartungsereignis starten
Sie können die VM-Wartung sofort starten, anstatt auf die geplante Zeit zu warten. Verwenden Sie die Google Cloud CLI oder die REST-Methode, um die VM-Wartung sofort auszulösen.
Wenn keine Benachrichtigung vorhanden ist und Sie versuchen, ein Wartungsereignis auszulösen, wird die folgende Meldung angezeigt:
There is no reschedulable upcoming maintenance.
Dies bedeutet, dass kein Wartungsereignis geplant wurde und keine Maßnahmen erforderlich sind.
gcloud
Wenn Sie die Wartung sofort starten möchten, verwenden Sie den Befehl
gcloud compute instances perform-maintenance
. Sie müssen die--zone=[ZONE_NAME]
angeben.gcloud compute instances perform-maintenance VM_NAME \ --zone=ZONE
Ersetzen Sie Folgendes:
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
maintenanceStatus
aufONGOING
gesetzt. Wartungsarbeiten werden durchgeführt.REST
Führen Sie den Befehl
instances.performMaintenance
aus, um die VM-Wartung auszulösen:POST: https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/VM_NAME/performMaintenance
Ersetzen Sie Folgendes:
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
maintenanceStatus
aufONGOING
gesetzt. Wartungsarbeiten werden durchgeführt.Definitionen des Wartungsstatus
Die folgenden Statusdefinitionen erklären die Antworten auf eine VM-Wartungsabfrage. Sie enthalten Informationen zur VM-Wartung. Google Cloud CLI, REST und der Metadatenserver verwenden dieselben Antworten:
Verhalten des Wartungsstatus
Während Sie den Wartungsplan verwalten, prüfen Sie den Status von
canReschedule=
undmaintenanceStatus=
. Diese Antwortkombinationen beschreiben das erwartete Feature-Verhalten und zeigen eine der folgenden Statuskombinationen an:Nächste Schritte
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-10-14 (UTC).
-