Method: projects.locations.runtimes.migrate

Esegui la migrazione di un runtime esistente a una nuova istanza Workbench.

Richiesta HTTP

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

Parametri del percorso

Parametri
name

string

Obbligatorio. Formato: projects/{projectId}/locations/{location}/runtimes/{runtimeId}

L'autorizzazione richiede una o più delle seguenti autorizzazioni IAM per la risorsa name specificata:

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

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "network": string,
  "subnet": string,
  "serviceAccount": string,
  "requestId": string,
  "postStartupScriptOption": enum (PostStartupScriptOption)
}
Campi
network

string

Facoltativo. Il nome del VPC in cui si trova la nuova istanza. Questo passaggio è obbligatorio se il runtime utilizza la rete gestita da Google. Se il runtime utilizza una rete di proprietà del cliente, riutilizzerà lo stesso VPC e questo campo deve essere vuoto. Formato: projects/{projectId}/global/networks/{network_id}

subnet

string

Facoltativo. Il nome della subnet in cui si trova la nuova istanza. Questo passaggio è obbligatorio se il runtime utilizza la rete gestita da Google. Se il runtime utilizza la rete di proprietà del cliente, riutilizzerà la stessa subnet e questo campo deve essere vuoto. Formato: projects/{projectId}/regions/{region}/subnetworks/{subnetwork_id}

serviceAccount

string

Facoltativo. Il account di servizio da includere nell'istanza Compute Engine della nuova istanza Workbench quando il runtime utilizza la modalità "solo singolo utente" per l'autorizzazione. Se non specificato, viene utilizzato l'account di servizio predefinito di Compute Engine. Quando il runtime utilizza la modalità account di servizio per l'autorizzazione, riutilizza lo stesso account di servizio e questo campo deve essere vuoto.

requestId

string

Facoltativo. UUID della richiesta idempotente.

postStartupScriptOption

enum (PostStartupScriptOption)

Facoltativo. Specifica il comportamento dello script post-avvio durante la migrazione.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per saperne di più, consulta la Authentication Overview.

PostStartupScriptOption

Specifica il comportamento dello script post-avvio durante la migrazione.

Enum
POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED L'opzione dello script post-avvio non è specificata. Il valore predefinito è POST_STARTUP_SCRIPT_OPTION_SKIP.
POST_STARTUP_SCRIPT_OPTION_SKIP Non eseguire la migrazione dello script post-avvio alla nuova istanza Workbench.
POST_STARTUP_SCRIPT_OPTION_RERUN Scarica di nuovo ed esegui lo stesso script post-avvio del notebook gestito da Google.