Method: projects.locations.runtimes.migrate

Migrar um ambiente de execução atual para uma nova instância do Workbench.

Solicitação HTTP

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

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. Formato: projects/{projectId}/locations/{location}/runtimes/{runtimeId}

A autorização requer uma ou mais das seguintes permissões de IAM no recurso name especificado:

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

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "network": string,
  "subnet": string,
  "serviceAccount": string,
  "requestId": string,
  "postStartupScriptOption": enum (PostStartupScriptOption)
}
Campos
network

string

Opcional. Nome da VPC em que a nova instância está. Isso é obrigatório se o ambiente de execução usar uma rede gerenciada pelo Google. Se o ambiente de execução usar uma rede de propriedade do cliente, ele vai reutilizar a mesma VPC, e esse campo precisa estar vazio. Formato: projects/{projectId}/global/networks/{network_id}

subnet

string

Opcional. Nome da sub-rede em que a nova instância está. Isso é obrigatório se o ambiente de execução usar uma rede gerenciada pelo Google. Se o ambiente de execução usar a rede do cliente, ele vai reutilizar a mesma sub-rede, e esse campo precisa estar vazio. Formato: projects/{projectId}/regions/{region}/subnetworks/{subnetwork_id}

serviceAccount

string

Opcional. A conta de serviço a ser incluída na instância do Compute Engine da nova instância do Workbench quando o ambiente de execução usa o modo "somente usuário único" para permissão. Se não for especificada, a conta de serviço padrão do Compute Engine será usada. Quando o ambiente de execução usa o modo de conta de serviço para permissão, ele reutiliza a mesma conta de serviço, e esse campo precisa estar vazio.

requestId

string

Opcional. UUID da solicitação idempotente.

postStartupScriptOption

enum (PostStartupScriptOption)

Opcional. Especifica o comportamento do script pós-inicialização durante a migração.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

PostStartupScriptOption

Especifica o comportamento do script pós-inicialização durante a migração.

Tipos enumerados
POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED A opção de script pós-inicialização não foi especificada. O padrão é POST_STARTUP_SCRIPT_OPTION_SKIP.
POST_STARTUP_SCRIPT_OPTION_SKIP Não migrar o script de pós-inicialização para a nova instância do Workbench.
POST_STARTUP_SCRIPT_OPTION_RERUN Baixe e execute novamente o mesmo script de inicialização pós-inicialização do notebook gerenciado pelo Google.