.TH "GCLOUD_COLAB_RUNTIMES_CREATE" 1



.SH "NAME"
.HP
gcloud colab runtimes create \- create a notebook runtime



.SH "SYNOPSIS"
.HP
\f5gcloud colab runtimes create\fR \fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR \fB\-\-runtime\-template\fR=\fIRUNTIME_TEMPLATE\fR [\fB\-\-async\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-region\fR=\fIREGION\fR] [\fB\-\-runtime\-id\fR=\fIRUNTIME_ID\fR] [\fB\-\-runtime\-user\fR=\fIRUNTIME_USER\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create a notebook runtime that can be used to run code from your notebook (IPYNB
file).



.SH "EXAMPLES"

To create a runtime in region 'us\-central1' with the display name 'my\-runtime'
and template with id 'my\-template', run:

.RS 2m
$ gcloud colab runtimes create \-\-region=us\-central1 \e
    \-\-display\-name=my\-runtime \-\-runtime\-template=my\-template
.RE

To create a runtime for user 'USER@DOMAIN.COM', run:

.RS 2m
$ gcloud colab runtimes create \-\-runtime\-user=USER@DOMAIN.COM \e
    \-\-region=us\-central1 \-\-display\-name=my\-runtime \e
    \-\-runtime\-template=my\-template
.RE



.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR

The display name of the runtime to create.

.TP 2m

Runtime template resource \- Unique name of the runtime template to configure
the runtime with. This was optionally provided by setting
\-\-runtime\-template\-id in the create runtime\-template command, or was
system\-generated if unspecified. 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 "\(em" 2m
provide the argument \f5\-\-runtime\-template\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

To set the \f5region\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-runtime\-template\fR on the command line with a
fully specified name;
.IP "\(em" 2m
provide the argument \f5\-\-region\fR on the command line;
.IP "\(em" 2m
set the property \f5colab/region\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fB\-\-runtime\-template\fR=\fIRUNTIME_TEMPLATE\fR

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

To set the \f5name\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-runtime\-template\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

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

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

.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

The description

.TP 2m
\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]

Add labels to identify and group the runtime template.

.TP 2m

Region resource \- Cloud region to create runtime. Please see
https://cloud.google.com/colab/docs/locations for a list of supported regions.
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 "\(em" 2m
provide the argument \f5\-\-region\fR on the command line with a fully specified
name;
.IP "\(em" 2m
set the property \f5colab/region\fR 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


.RS 2m
.TP 2m
\fB\-\-region\fR=\fIREGION\fR

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

To set the \f5region\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-region\fR on the command line;
.IP "\(bu" 2m
set the property \f5colab/region\fR.
.RE
.sp

.RE
.sp
.TP 2m
\fB\-\-runtime\-id\fR=\fIRUNTIME_ID\fR

The id of the runtime to create. If not specified, a random id will be
generated.

.TP 2m
\fB\-\-runtime\-user\fR=\fIRUNTIME_USER\fR

User email for the runtime owner. Runtimes can only be used by the owner. If a
user is not provided, the gcloud user will be assumed to be the owner. The user
cannot be a service account.


.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.



.SH "NOTES"

This variant is also available:

.RS 2m
$ gcloud beta colab runtimes create
.RE