.TH "GCLOUD_NOTEBOOKS_RUNTIMES_MIGRATE" 1



.SH "NAME"
.HP
gcloud notebooks runtimes migrate \- request for migrating runtimes



.SH "SYNOPSIS"
.HP
\f5gcloud notebooks runtimes migrate\fR (\fIRUNTIME\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) [\fB\-\-async\fR] [\fB\-\-post\-startup\-script\-option\fR=\fIPOST_STARTUP_SCRIPT_OPTION\fR;\ default=\f5"POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED"\fR] [\fB\-\-service\-account\fR=\fISERVICE_ACCOUNT\fR] [\fB\-\-network\fR=\fINETWORK\fR\ [\fB\-\-subnet\fR=\fISUBNET\fR\ :\ \fB\-\-subnet\-region\fR=\fISUBNET_REGION\fR]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Request for migrating notebook runtimes.



.SH "EXAMPLES"

To migrate a runtime, run:

.RS 2m
$ gcloud notebooks runtimes migrate example\-runtime \e
  \-\-location=us\-central1
.RE

To migrate a runtime with a new custom network, run:

.RS 2m
$ gcloud notebooks runtimes migrate example\-runtime \e
  \-\-location=us\-central1 \e
  \-\-network=projects/example\-project/global/networks/\e
example\-network \e
    \-\-subnet=projects/example\-project/regions/us\-central1/\e
subnetworks/example\-subnetwork
.RE

To migrate a runtime and reuse the post\-startup script, run:

.RS 2m
$ gcloud notebooks runtimes migrate example\-runtime \e
  \-\-location=us\-central1 \e
  \-\-post\-startup\-script\-option=POST_STARTUP_SCRIPT_OPTION_RERUN
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Runtime resource \- User\-defined unique name of this runtime. The runtime name
must be 1 to 63 characters long and contain only lowercase letters, numeric
characters, and dashes. The first character must be a lowercase letter and the
last character cannot be a dash. The arguments in this group can be used to
specify the attributes of this resource. (NOTE) Some attributes are not given
arguments in this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5runtime\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIRUNTIME\fR

ID of the runtime or fully qualified identifier for the runtime.

To set the \f5runtime\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5runtime\fR on the command line.
.RE
.sp

This positional argument must be specified if any of the other arguments in this
group are specified.

.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

Google Cloud location of this runtime
https://cloud.google.com/compute/docs/regions\-zones/#locations.

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5runtime\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line;
.IP "\(bu" 2m
set the property \f5notebooks/location\fR.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.

.TP 2m
\fB\-\-post\-startup\-script\-option\fR=\fIPOST_STARTUP_SCRIPT_OPTION\fR; default=\f5"POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED"\fR

Specifies the behavior of post startup script during migration.
\fIPOST_STARTUP_SCRIPT_OPTION\fR must be one of:
\fBPOST_STARTUP_SCRIPT_OPTION_UNSPECIFIED\fR,
\fBPOST_STARTUP_SCRIPT_OPTION_SKIP\fR, \fBPOST_STARTUP_SCRIPT_OPTION_RERUN\fR.

.TP 2m
\fB\-\-service\-account\fR=\fISERVICE_ACCOUNT\fR

The service account to be included in the Compute Engine instance of the new
Workbench Instance when the Runtime uses single user only mode for permission.
If not specified, the Compute Engine default service account
(https://cloud.google.com/compute/docs/access/service\-accounts#default_service_account)
is used. When the Runtime uses service account mode for permission, it will
reuse the same service account, and this field must be empty.

.TP 2m

Network configs.


.RS 2m
.TP 2m

Network resource \- The name of the VPC that this instance is in. Format:
projects/\f5{project_id}\fR/global/networks/\f5{network_id}\fR. This represents
a Cloud resource. (NOTE) Some attributes are not given arguments in this group
but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-network\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(bu" 2m
set the property \f5core/project\fR.
.RE
.sp


.RS 2m
.TP 2m
\fB\-\-network\fR=\fINETWORK\fR

ID of the network or fully qualified identifier for the network.

To set the \f5network\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-network\fR on the command line.
.RE
.sp

.RE
.sp
.TP 2m

Subnetwork resource \- The name of the subnet that this instance is in. Format:
projects/\f5{project_id}\fR/regions/\f5{region}\fR/subnetworks/\f5{subnetwork_id}\fR.
The arguments in this group can be used to specify the attributes of this
resource. (NOTE) Some attributes are not given arguments in this group but can
be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-subnet\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(bu" 2m
set the property \f5core/project\fR.
.RE
.sp


.RS 2m
.TP 2m
\fB\-\-subnet\fR=\fISUBNET\fR

ID of the subnetwork or fully qualified identifier for the subnetwork.

To set the \f5subnet\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-subnet\fR on the command line.
.RE
.sp

This flag argument must be specified if any of the other arguments in this group
are specified.

.TP 2m
\fB\-\-subnet\-region\fR=\fISUBNET_REGION\fR

Google Cloud region of this subnetwork
https://cloud.google.com/compute/docs/regions\-zones/#locations.

To set the \f5subnet\-region\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-subnet\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-subnet\-region\fR on the command line.
.RE
.sp


.RE
.RE
.RE
.sp

.SH "GCLOUD WIDE FLAGS"

These flags are available to all commands: \-\-access\-token\-file, \-\-account,
\-\-billing\-project, \-\-configuration, \-\-flags\-file, \-\-flatten,
\-\-format, \-\-help, \-\-impersonate\-service\-account, \-\-log\-http,
\-\-project, \-\-quiet, \-\-trace\-token, \-\-user\-output\-enabled,
\-\-verbosity.

Run \fB$ gcloud help\fR for details.