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 管理的笔记本相同的启动后脚本。