Method: projects.locations.runtimes.migrate

Vorhandene Laufzeit zu einer neuen Workbench-Instanz migrieren

HTTP-Anfrage

POST https://notebooks.googleapis.com/v1/{name}:migrate

Pfadparameter

Parameter
name

string

Erforderlich. Format: projects/{projectId}/locations/{location}/runtimes/{runtimeId}

Zur Autorisierung ist mindestens eine der folgenden IAM-Berechtigungen für die angegebene Ressource name erforderlich:

  • notebooks.runtimes.get
  • notebooks.instances.create

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "network": string,
  "subnet": string,
  "serviceAccount": string,
  "requestId": string,
  "postStartupScriptOption": enum (PostStartupScriptOption)
}
Felder
network

string

Optional. Name der VPC, in der sich die neue Instanz befindet. Dies ist erforderlich, wenn die Laufzeit ein von Google verwaltetes Netzwerk verwendet. Wenn für die Laufzeit ein vom Kunden bereitgestelltes Netzwerk verwendet wird, wird dieselbe VPC wiederverwendet und dieses Feld muss leer sein. Format: projects/{projectId}/global/networks/{network_id}
subnet

string

Optional. Name des Subnetzes, in dem sich die neue Instanz befindet. Dies ist erforderlich, wenn die Laufzeit ein von Google verwaltetes Netzwerk verwendet. Wenn die Laufzeit ein vom Kunden bereitgestelltes Netzwerk verwendet, wird dasselbe Subnetz wiederverwendet und dieses Feld muss leer sein. Format: projects/{projectId}/regions/{region}/subnetworks/{subnetwork_id}
serviceAccount

string

Optional. Das Dienstkonto, das in die Compute Engine-Instanz der neuen Workbench-Instanz aufgenommen werden soll, wenn die Laufzeit den Modus „Nur ein Nutzer“ für die Berechtigung verwendet. Wenn nicht angegeben, wird das Compute Engine-Standarddienstkonto verwendet. Wenn die Laufzeit den Dienstkontomodus für Berechtigungen verwendet, wird dasselbe Dienstkonto wiederverwendet und dieses Feld muss leer sein.
requestId

string

Optional. UUID für idempotente Anfragen.
postStartupScriptOption

enum (PostStartupScriptOption)

Optional. Gibt das Verhalten des Post-Startscripts während der Migration an.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/notebooks

Weitere Informationen finden Sie unter Authentication Overview.

PostStartupScriptOption

Gibt das Verhalten des Post-Startscripts während der Migration an.

Enums
POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED Die Option für das Post-Startscript ist nicht angegeben. Die Standardeinstellung ist POST_STARTUP_SCRIPT_OPTION_SKIP.
POST_STARTUP_SCRIPT_OPTION_SKIP Das Post-Startscript wird nicht in die neue Workbench-Instanz migriert.
POST_STARTUP_SCRIPT_OPTION_RERUN Laden Sie das Post-Startscript noch einmal herunter und führen Sie es noch einmal aus, genau wie beim von Google verwalteten Notebook.