Sie können eine Compute Engine-Instanz manuell beenden, wenn Sie sie nicht mehr verwenden oder ihre Eigenschaften ändern möchten, z. B. den Maschinentyp ändern oder angehängte und eingebundene Laufwerke entfernen. Nachdem die Instanz beendet wurde, können Sie sie neu starten, um Ihre Arbeitslast fortzusetzen, oder sie löschen, wenn Sie sie nicht mehr benötigen.
In diesem Dokument wird beschrieben, wie Sie eine Instanz manuell beenden oder neu starten. Informationen zum Automatisieren des Beendens oder Neustartens einer Instanz finden Sie unter:
Beschränkungen
Wenn Sie eine Compute-Instanz beenden, gelten die folgenden Einschränkungen:
Sie können eine Instanz nur beenden oder neu starten, wenn der Instanzstatus dies zulässt.
Sie können eine Instanz nur neu starten, wenn in der Zone der Instanz genügend Ressourcen vorhanden sind.
TPU-Instanzen können nicht neu gestartet werden.
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 Art und Weise aus, wie Sie die Beispiele auf dieser Seite verwenden möchten:
Console
Wenn Sie über die Google Cloud Console auf Google Cloud Dienste und APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.
gcloud
-
Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl:
gcloud initWenn 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.
-
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.
-
Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Nutzerkonto:
gcloud auth application-default login
Wenn Sie Cloud Shell verwenden, müssen Sie das nicht tun.
Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.
-
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.
-
Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Nutzerkonto:
gcloud auth application-default login
Wenn Sie Cloud Shell verwenden, müssen Sie das nicht tun.
Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.
-
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.
-
Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Nutzerkonto:
gcloud auth application-default login
Wenn Sie Cloud Shell verwenden, müssen Sie das nicht tun.
Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.
-
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.
-
Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Nutzerkonto:
gcloud auth application-default login
Wenn Sie Cloud Shell verwenden, müssen Sie das nicht tun.
Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.
-
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.
-
Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Nutzerkonto:
gcloud auth application-default login
Wenn Sie Cloud Shell verwenden, müssen Sie das nicht tun.
Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.
Go
Wenn Sie die Go-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.
Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Wenn Sie die Java-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.
Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Wenn Sie die Node.js-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.
Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
PHP
Wenn Sie die PHP-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.
Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Wenn Sie die Python-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.
Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
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
Um die Berechtigungen zu erhalten, die Sie zum Beenden oder Neustarten einer Compute-Instanz benötigen, bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) für das 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 Beenden oder Neustarten einer Compute-Instanz erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um eine Compute-Instanz zu stoppen oder neu zu starten:
-
So beenden Sie eine Instanz:
compute.instances.stopfür die Instanz -
So beenden Sie eine Instanz über das Gastbetriebssystem:
compute.instances.setMetadatafür die Instanz, wenn sie öffentliche SSH-Schlüssel auf Instanzebene verwendet. -
So starten Sie eine Instanz neu:
compute.instances.startfür die Instanz -
So starten Sie eine Instanz neu, die Verschlüsselungsschlüssel verwendet:
compute.instances.startWithEncryptionKeyfür die Instanz
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Instanz beenden
Wenn Sie eine Compute-Instanz beenden oder Compute Engine dies im Rahmen einer geplanten Aktion tut, behält die Instanz ihre angehängten Laufwerke, Konfigurationseinstellungen, IP-Adressen, MAC-Adressen und Instanzmetadaten bei. Wenn Sie auch In-Memory-Daten und den Anwendungsstatus beibehalten möchten, halten Sie die Instanz an.
Je nachdem, ob an die Instanz lokale SSD-Laufwerke angehängt sind und wie Sie Herunterfahrskripts verarbeiten möchten, können Sie die Instanz mit einer der folgenden Methoden beenden:
Instanz über Google Cloud beenden. Sie können eine oder mehrere Instanzen gleichzeitig über Google Cloudbeenden. Wenn den Instanzen lokale SSD-Laufwerke angehängt sind, können Sie auswählen, ob Sie lokale SSD-Daten verwerfen oder beibehalten möchten (Vorschau). Alle Shutdown-Skripts in der Instanz müssen bis zum Ende des standardmäßigen Shutdown-Zeitraums ausgeführt werden.
Eine Anleitung finden Sie hier:
Instanz über das Gastbetriebssystem beenden Sie können eine einzelne Instanz über das Gastbetriebssystem beenden. Mit diesem Ansatz können Sie eine Instanz erst beenden, nachdem ihre Shutdown-Skripts ausgeführt wurden. Wenn Sie das ordnungsgemäße Herunterfahren aktiviert haben, können Sie die Instanz auch ohne ordnungsgemäßes Herunterfahren beenden oder ein laufendes ordnungsgemäßes Herunterfahren beenden. Wenn Sie Daten von angehängten lokalen SSD-Laufwerken nicht manuell auf einem dauerhaften Speichervolume sichern, werden alle Daten auf diesen Laufwerken verworfen, wenn Sie eine Instanz über das Gastbetriebssystem beenden.
Eine Anleitung finden Sie unter Instanz über das Gastbetriebssystem beenden.
Instanz ohne lokale SSDs beenden
Je nachdem, was Sie beim Beenden einer Instanz tun möchten, haben Sie folgende Möglichkeiten:
Wenn Sie das ordnungsgemäße Herunterfahren in der Instanz aktiviert haben, können Sie die Instanz über die Google Cloud Console, die gcloud CLI oder die REST API beenden, ohne sie ordnungsgemäß herunterzufahren, oder ein laufendes ordnungsgemäßes Herunterfahren beenden.
Wenn Sie mehrere Instanzen gleichzeitig beenden möchten, verwenden Sie die Google Cloud Console oder, für Instanzen in derselben Zone, die gcloud CLI.
Wählen Sie eine der folgenden Optionen aus, um eine oder mehrere Instanzen zu beenden:
Console
Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Wählen Sie die laufenden Instanzen aus, die Sie beenden möchten.
Klicken Sie auf Beenden. Wenn die Option Beenden nicht angezeigt wird, klicken Sie auf Weitere Aktionen > Beenden.
Führen Sie im angezeigten Dialogfeld die folgenden Schritte aus:
Optional: Wenn Sie die Instanzen beenden möchten, ohne sie ordnungsgemäß herunterzufahren, oder ein laufendes ordnungsgemäßes Herunterfahren beenden möchten, wählen Sie das Kästchen Ordnungsgemäßes Herunterfahren überspringen (falls zutreffend) aus.
Klicken Sie zur Bestätigung auf Beenden.
gcloud
Wenn Sie eine oder mehrere Instanzen in derselben Zone beenden möchten, verwenden Sie den Befehl gcloud compute instances stop:
gcloud compute instances stop INSTANCE_NAMES \
--zone=ZONE
Ersetzen Sie Folgendes:
INSTANCE_NAMES: Eine durch Leerzeichen getrennte Liste von Instanznamen, z. B.instance-01 instance-02 instance-03.ZONE: die Zone, in der sich die Instanzen befinden.
Wenn Sie in einer oder mehreren Instanzen das ordnungsgemäße Herunterfahren aktiviert haben, können Sie die Instanzen optional anhalten, ohne sie ordnungsgemäß herunterzufahren, oder ein laufendes ordnungsgemäßes Herunterfahren manuell beenden. Führen Sie dazu den Befehl gcloud beta compute instances stop mit dem Flag --no-graceful-shutdown aus:
gcloud beta compute instances stop INSTANCE_NAMES \
--no-graceful-shutdown \
--zone=ZONE
Go
Java
Node.js
PHP
Python
REST
Senden Sie zum Beenden einer Instanz eine POST-Anfrage an die Methode instances.stop:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop
Ersetzen Sie Folgendes:
INSTANCE_NAME: der Name der Instanz.PROJECT_ID: die ID des Projekts, in dem sich die Instanz befindet.ZONE: die Zone, in der sich die Instanz befindet.
Wenn Sie in einer Instanz das ordnungsgemäße Herunterfahren aktiviert haben, können Sie die Instanz optional beenden, ohne sie ordnungsgemäß herunterzufahren, oder ein laufendes ordnungsgemäßes Herunterfahren manuell beenden. Senden Sie dazu eine POST-Anfrage an die instances.stop-Methode. Fügen Sie in die Anfrage-URL den Abfrageparameter noGracefulShutdown=true ein:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop?noGracefulShutdown=true
Instanz mit lokalen SSD-Laufwerken beenden
Je nachdem, was Sie beim Beenden einer Compute-Instanz tun möchten, haben Sie folgende Möglichkeiten:
Wenn Sie das ordnungsgemäße Herunterfahren in der Instanz aktiviert haben, können Sie die Instanz über die Google Cloud Console, die gcloud CLI oder die REST API beenden, ohne sie ordnungsgemäß herunterzufahren, oder ein laufendes ordnungsgemäßes Herunterfahren beenden.
Wenn Sie die Daten der an eine Instanz angehängten lokalen SSD-Laufwerke beibehalten möchten (mit Ausnahme von Maschinentypen, die Titanium-SSDs verwenden), beenden Sie die Instanz mit der gcloud CLI oder der REST API.
Wenn Sie mehrere Instanzen gleichzeitig beenden möchten, verwenden Sie die Google Cloud Console oder, für Instanzen in derselben Zone, die gcloud CLI.
Wenn Sie eine oder mehrere Instanzen mit angehängten lokalen SSD-Laufwerken beenden möchten, wählen Sie eine der folgenden Optionen aus:
Console
Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Wählen Sie die laufenden Instanzen aus, die Sie beenden möchten.
Klicken Sie auf Beenden. Wenn die Option Beenden nicht angezeigt wird, klicken Sie auf Weitere Aktionen > Beenden.
Gehen Sie im Dialogfeld so vor:
Optional: Wenn Sie die Instanzen beenden möchten, ohne sie ordnungsgemäß herunterzufahren, oder ein laufendes ordnungsgemäßes Herunterfahren beenden möchten, wählen Sie das Kästchen Ordnungsgemäßes Herunterfahren überspringen (falls zutreffend) aus.
Klicken Sie zur Bestätigung auf Beenden.
gcloud
Wenn Sie eine oder mehrere Instanzen in derselben Zone beenden, an die lokale SSD-Laufwerke angehängt sind, geben Sie an, ob lokale SSD-Daten verworfen oder beibehalten werden sollen:
Verwenden Sie den Befehl
gcloud compute instances stopmit dem Flag--discard-local-ssd=true, um lokale SSD-Daten zu verwerfen:gcloud compute instances stop INSTANCE_NAMES \ --discard-local-ssd=true \ --zone=ZONEWenn Sie lokale SSD-Daten beibehalten möchten, verwenden Sie den Befehl
gcloud beta compute instances stopmit dem Flag--discard-local-ssd=false:gcloud beta compute instances stop INSTANCE_NAMES \ --discard-local-ssd=false \ --zone=ZONE
Ersetzen Sie Folgendes:
INSTANCE_NAMES: Eine durch Leerzeichen getrennte Liste von Instanznamen, z. B.instance-01 instance-02 instance-03.ZONE: die Zone, in der sich die Instanzen befinden.
Wenn Sie in einer oder mehreren Instanzen die ordnungsgemäße Beendigung aktiviert haben, können Sie die Instanzen optional beenden, ohne sie ordnungsgemäß herunterzufahren, oder eine laufende ordnungsgemäße Beendigung beenden. Führen Sie dazu den Befehl gcloud beta compute instances stop mit dem Flag --no-graceful-shutdown aus:
gcloud beta compute instances stop INSTANCE_NAMES \
--discard-local-ssd=DISCARD_LOCAL_SSD \
--no-graceful-shutdown \
--zone=ZONE
Ersetzen Sie DISCARD_LOCAL_SSD durch true, um die Daten auf den lokalen SSD-Laufwerken zu verwerfen, oder durch false, um die Daten beizubehalten.
REST
Wenn Sie eine Instanz mit angehängten lokalen SSD-Laufwerken beenden, geben Sie an, ob die lokalen SSD-Daten verworfen oder beibehalten werden sollen:
Wenn Sie lokale SSD-Daten verwerfen möchten, stellen Sie eine
POST-Anfrage an die Methodeinstances.stop. Fügen Sie in der Anfrage-URL den AbfrageparameterdiscardLocalSsdein, wobei dieser auftruegesetzt ist:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop?discardLocalSsd=trueWenn Sie lokale SSD-Daten beibehalten möchten, stellen Sie eine
POST-Anfrage an die Methodebeta.instances.stop. Fügen Sie in der Anfrage-URL den AbfrageparameterdiscardLocalSsdein, wobei dieser auffalsegesetzt ist:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop?discardLocalSsd=false
Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, in dem sich die Instanz befindet.ZONE: die Zone, in der sich die Instanz befindet.INSTANCE_NAME: der Name der Instanz.
Wenn Sie das ordnungsgemäße Herunterfahren in einer Instanz aktiviert haben, können Sie die Instanz optional beenden, ohne sie ordnungsgemäß herunterzufahren, oder ein laufendes ordnungsgemäßes Herunterfahren manuell beenden. Stellen Sie dazu eine POST-Anfrage an die Methode instances.stop.
Fügen Sie in der Anfrage-URL den Abfrageparameter noGracefulShutdown=true ein:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop?discardLocalSsd=DISCARD_LOCAL_SSD&noGracefulShutdown=true
Ersetzen Sie DISCARD_LOCAL_SSD durch true, um die Daten auf den lokalen SSD-Laufwerken zu verwerfen, oder durch false, um die Daten beizubehalten.
Instanz über das Gastbetriebssystem beenden
Wenn an eine Compute-Instanz lokale SSD-Laufwerke angehängt sind, werden die lokalen SSD-Daten beim Herunterfahren des Gastbetriebssystems automatisch verworfen. Wenn Sie diese Daten beibehalten möchten, kopieren Sie sie manuell in eine nichtflüchtige Speicheroption, bevor Sie die Instanz beenden.
Wählen Sie eine der folgenden Optionen aus, um eine Instanz über das Gastbetriebssystem zu beenden:
Linux
Stellen Sie eine Verbindung zur Instanz her, falls noch nicht geschehen.
Wählen Sie eine der folgenden Methoden aus, um die Instanz zu beenden:
Führen Sie den folgenden Befehl aus, um ein ordnungsgemäßes Herunterfahren zu erzwingen, bei dem die Instanz Herunterfahrskripts ausführen kann, bevor das Gastbetriebssystem heruntergefahren wird:
sudo shutdown -h nowAndernfalls führen Sie den folgenden Befehl aus, um das Herunterfahren zu erzwingen:
sudo poweroff
Windows
Wenn Sie noch keine Verbindung zur Instanz hergestellt haben, verwenden Sie eine der folgenden Methoden:
Wählen Sie eine der folgenden Methoden aus, um die Instanz zu beenden:
Wenn Sie die Instanz ordnungsgemäß beenden und die Instanz vor dem Herunterfahren des Gastbetriebssystems Herunterfahrskripts ausführen lassen möchten, führen Sie den folgenden Befehl aus:
shutdown /sFühren Sie den folgenden Befehl aus, um das Herunterfahren zu erzwingen:
shutdown /f
Instanz neu starten
Sie können eine Compute-Instanz neu starten, die vollständig beendet wurde. Der Instanzstatus ist dann TERMINATED.
Wenn Sie beim Beenden der Instanz die Daten Ihrer lokalen SSD-Laufwerke beibehalten haben, müssen Sie die lokalen SSD-Laufwerke nach dem Neustart möglicherweise neu einbinden. Weitere Informationen zum Bereitstellen lokaler SSD-Laufwerke finden Sie unter Lokales SSD-Gerät formatieren und bereitstellen.
Verwenden Sie zum Neustarten einer Instanz eine der folgenden Methoden, je nachdem, ob die Instanz Laufwerke hat, die mit vom Kunden bereitgestellten Verschlüsselungsschlüsseln (CSEK) verschlüsselt wurden:
Wenn an Ihre Instanz keine CSEK-verschlüsselten Laufwerke angehängt sind, lesen Sie den Abschnitt Instanz ohne CSEK-verschlüsselte Laufwerke neu starten.
Andernfalls lesen Sie Instanz mit CSEK-verschlüsselten Laufwerken neu starten.
Instanz ohne CSEK-verschlüsselte Laufwerke neu starten
Wenn Sie mehrere Instanzen gleichzeitig in verschiedenen Zonen neu starten möchten, verwenden Sie dieGoogle Cloud Console. Für Instanzen in derselben Zone können Sie die gcloud CLI verwenden. Wählen Sie andernfalls eine der folgenden Optionen für andere Neustartszenarien aus:
Console
Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Wählen Sie eine oder mehrere Instanzen aus.
Klicken Sie auf Starten/Fortsetzen.
gcloud
Wenn Sie eine oder mehrere Instanzen in derselben Zone neu starten möchten, verwenden Sie den gcloud compute instances start-Befehl:
gcloud compute instances start INSTANCE_NAMES \
--zone=ZONE
Ersetzen Sie Folgendes:
INSTANCE_NAMES: Eine durch Leerzeichen getrennte Liste von Instanznamen, z. B.instance-01 instance-02 instance-03.ZONE: die Zone, in der sich die Instanzen befinden.
Go
Java
Node.js
PHP
Python
REST
Wenn Sie eine Instanz neu starten möchten, senden Sie eine POST-Anfrage an die Methode instances.start:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/start
Ersetzen Sie Folgendes:
INSTANCE_NAME: der Name der Instanz, die neu gestartet werden soll.PROJECT_ID: die ID des Projekts, in dem sich die Instanz befindet.ZONE: die Zone, in der sich die Instanz befindet.
Instanz mit CSEK-verschlüsselten Laufwerken neu starten
Wenn Sie eine angehaltene Compute-Instanz neu starten, an die Laufwerke angehängt sind, die mit vom Kunden bereitgestellten Verschlüsselungsschlüsseln verschlüsselt wurden, müssen Sie die Informationen zum Verschlüsselungsschlüssel angeben.
Wenn Sie mehrere Instanzen gleichzeitig in verschiedenen Zonen neu starten möchten, verwenden Sie dieGoogle Cloud Console. Für Instanzen in derselben Zone können Sie die gcloud CLI verwenden. Wählen Sie andernfalls eine der folgenden Optionen für andere Neustartszenarien aus:
Console
Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Wählen Sie die Instanzen aus, die neu gestartet werden sollen.
Klicken Sie auf Starten/Fortsetzen.
Geben Sie Verschlüsselungsschlüssel für alle verschlüsselten Laufwerke an, die an die Instanzen angehängt sind, und klicken Sie dann auf Starten.
gcloud
Wenn Sie eine oder mehrere Instanzen, die verschlüsselte Laufwerke in derselben Zone verwenden, neu starten möchten, verwenden Sie den Befehl gcloud compute instances start mit dem Flag --csek-key-file. Wenn Sie einen mit RSA verpackten Schlüssel verwenden, nutzen Sie stattdessen den Befehl gcloud beta compute instances start mit dem Flag --csek-key-file:
gcloud compute instances start INSTANCE_NAMES \
--csek-key-file=ENCRYPTION_KEY_FILE \
--zone=ZONE
Ersetzen Sie Folgendes:
INSTANCE_NAMES: Eine durch Leerzeichen getrennte Liste von Instanznamen, z. B.instance-01 instance-02 instance-03.ENCRYPTION_KEY_FILE: der relative Pfad zur JSON-Datei, die den vom Kunden bereitgestellten Verschlüsselungsschlüssel enthält. Sie können mehrere Instanzen nur dann gleichzeitig neu starten, wenn sie denselben vom Kunden bereitgestellten Verschlüsselungsschlüssel verwenden. Das Format der Datei wird unter Schlüsseldateiformat beschrieben.ZONE: die Zone, in der sich die Instanzen befinden.
Go
Java
Node.js
PHP
Python
REST
Um eine Instanz mit verschlüsselten Laufwerken neu zu starten, stellen Sie eine POST-Anfrage an die Methode instances.startWithEncryptionKey:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/startWithEncryptionKey
{
"disks": [
{
"source": "DISK_URL",
"diskEncryptionKey": {
"ENCRYPTION_TYPE": "ENCRYPTION_KEY"
}
}
]
}
Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, in dem sich die Instanz befindet.ZONE: die Zone, in der sich die Instanz befindet.INSTANCE_NAME: der Name der Instanz.DISK_URL: Ressourcen-URL, die dem vollständigen Ressourcennamen des angehängten Laufwerks entspricht und mit einem vom Kunden bereitgestellten Verschlüsselungsschlüssel verschlüsselt istENCRYPTION_TYPE: Der Typ der verwendeten Laufwerksverschlüsselung, die einer der folgenden Werte sein kann:rawKey,kmsKeyNameoderrsaEncryptedKey. Wenn Sie den TyprsaEncryptedKeyverwenden, stellen Sie einePOST-Anfrage an die Methodebeta.instances.startWithEncryptionKey.ENCRYPTION_KEY: der Verschlüsselungsschlüssel, der zum Verschlüsseln der an die Instanz angehängten nichtflüchtigen Speicher verwendet wird. Schlüssel vom TyprawKeyoderrsaEncryptedKeymüssen base64-codiert sein. Informationen zum Vorbereiten einesrsaEncryptedKey-Schlüssels finden Sie unter RSA-Key-Wrapping.