Method: projects.locations.runtimes.migrate

將現有執行階段遷移至新的 Workbench 執行個體。

HTTP 要求

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

路徑參數

參數
name

string

這是必要旗標，格式：projects/{projectId}/locations/{location}/runtimes/{runtimeId}

如要授權，必須具備指定資源 name 的下列一或多項 IAM 權限：

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

要求主體

要求主體包含下列結構的資料：

JSON 表示法 
{
  "network": string,
  "subnet": string,
  "serviceAccount": string,
  "requestId": string,
  "postStartupScriptOption": enum (PostStartupScriptOption)
}
欄位
network

string

選用。新執行個體所在的 VPC 名稱。如果執行階段使用 Google 代管的網路，就必須執行這項操作。如果執行階段使用客戶擁有的網路，則會重複使用相同的 VPC，且這個欄位必須空白。格式：projects/{projectId}/global/networks/{network_id}
subnet

string

選用。新執行個體所在的子網路名稱。如果執行階段使用 Google 代管的網路，就必須執行這項操作。如果執行階段使用客戶擁有的網路，系統會重複使用相同的子網路，因此這個欄位必須空白。格式：projects/{projectId}/regions/{region}/subnetworks/{subnetwork_id}
serviceAccount

string

選用。當執行階段使用「僅限單一使用者」模式取得權限時，要納入新 Workbench 執行個體 Compute Engine 執行個體的服務帳戶。如未指定，則會使用 Compute Engine 預設服務帳戶。如果執行階段使用服務帳戶模式取得權限，系統會重複使用同一個服務帳戶，因此這個欄位必須空白。
requestId

string

選用。冪等要求 UUID。
postStartupScriptOption

enum (PostStartupScriptOption)

選用。指定遷移期間開機指令碼的行為。

回應主體

如果成功，回應主體會包含 Operation 的執行個體。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。

PostStartupScriptOption

指定遷移期間開機指令碼的行為。

列舉
POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED 未指定開機後指令碼選項。預設為 POST_STARTUP_SCRIPT_OPTION_SKIP。
POST_STARTUP_SCRIPT_OPTION_SKIP 不會將啟動後開機指令碼遷移至新的 Workbench 執行個體。
POST_STARTUP_SCRIPT_OPTION_RERUN 重新下載並重新執行與 Google 管理的筆記本相同的啟動後指令碼。