Method: projects.locations.runtimes.migrate

Migra un entorno de ejecución existente a una instancia nueva de Workbench.

Solicitud HTTP

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

Parámetros de ruta

Parámetros
name

string

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

La autorización requiere uno o más de los siguientes permisos de IAM en el recurso name especificado:

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "network": string,
  "subnet": string,
  "serviceAccount": string,
  "requestId": string,
  "postStartupScriptOption": enum (PostStartupScriptOption)
}
Campos
network

string

Es opcional. Es el nombre de la VPC en la que se encuentra la instancia nueva. Esto es obligatorio si el entorno de ejecución usa una red administrada por Google. Si el entorno de ejecución usa una red propiedad del cliente, reutilizará la misma VPC, y este campo debe estar vacío. Formato: projects/{projectId}/global/networks/{network_id}
subnet

string

Es opcional. Nombre de la subred en la que se encuentra la instancia nueva. Esto es obligatorio si el entorno de ejecución usa una red administrada por Google. Si el entorno de ejecución usa una red propiedad del cliente, reutilizará la misma subred y este campo debe estar vacío. Formato: projects/{projectId}/regions/{region}/subnetworks/{subnetwork_id}
serviceAccount

string

Es opcional. Es la cuenta de servicio que se incluirá en la instancia de Compute Engine de la nueva instancia de Workbench cuando el tiempo de ejecución use el modo "solo usuario único" para el permiso. Si no se especifica, se usa la cuenta de servicio predeterminada de Compute Engine. Cuando el entorno de ejecución usa el modo de cuenta de servicio para el permiso, reutilizará la misma cuenta de servicio, y este campo debe estar vacío.
requestId

string

Es opcional. Es el UUID de la solicitud idempotente.
postStartupScriptOption

enum (PostStartupScriptOption)

Es opcional. Especifica el comportamiento de la secuencia de comandos de inicio posterior durante la migración.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.

PostStartupScriptOption

Especifica el comportamiento de la secuencia de comandos de inicio posterior durante la migración.

Enums
POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED No se especificó la opción de secuencia de comandos posterior al inicio. El valor predeterminado es POST_STARTUP_SCRIPT_OPTION_SKIP.
POST_STARTUP_SCRIPT_OPTION_SKIP No migrar la secuencia de comandos posterior al inicio a la nueva instancia de Workbench
POST_STARTUP_SCRIPT_OPTION_RERUN Vuelve a descargar y a ejecutar la misma secuencia de comandos de inicio que el notebook administrado por Google.