.TH "GCLOUD_COLAB_RUNTIME\-TEMPLATES_CREATE" 1



.SH "NAME"
.HP
gcloud colab runtime\-templates create \- create a runtime template



.SH "SYNOPSIS"
.HP
\f5gcloud colab runtime\-templates create\fR \fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR [\fB\-\-async\fR] [\fB\-\-region\fR=\fIREGION\fR] [\fB\-\-runtime\-template\-id\fR=\fIRUNTIME_TEMPLATE_ID\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR\ \fB\-\-no\-enable\-euc\fR\ \fB\-\-enable\-secure\-boot\fR\ \fB\-\-idle\-shutdown\-timeout\fR=\fIIDLE_SHUTDOWN_TIMEOUT\fR;\ default="3h"\ \fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]\ \fB\-\-network\-tags\fR=[\fITAGS\fR,...]\ \fB\-\-accelerator\-count\fR=\fIACCELERATOR_COUNT\fR\ \fB\-\-accelerator\-type\fR=\fIACCELERATOR_TYPE\fR\ \fB\-\-machine\-type\fR=\fIMACHINE_TYPE\fR;\ default="e2\-standard\-4"\ \fB\-\-disk\-size\-gb\fR=\fIDISK_SIZE_GB\fR;\ default=100\ \fB\-\-disk\-type\fR=\fIDISK_TYPE\fR;\ default=\f5"PD_STANDARD"\fR\ [\fB\-\-kms\-key\fR=\fIKMS_KEY\fR\ :\ \fB\-\-kms\-keyring\fR=\fIKMS_KEYRING\fR\ \fB\-\-kms\-location\fR=\fIKMS_LOCATION\fR\ \fB\-\-kms\-project\fR=\fIKMS_PROJECT\fR]\ \fB\-\-no\-enable\-internet\-access\fR\ \fB\-\-network\fR=\fINETWORK\fR\ [\fB\-\-subnetwork\fR=\fISUBNETWORK\fR\ :\ \fB\-\-subnetwork\-region\fR=\fISUBNETWORK_REGION\fR]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create a Colab Enterprise runtime template, a VM configuration for your notebook
runtimes.



.SH "EXAMPLES"

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

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

To create a runtime template for a VM with machine type n1\-standard\-2 and one
NVIDIA_TESLA_V100 accelerator, run:

.RS 2m
$ gcloud colab runtime\-templates create \e
    \-\-machine\-type=n1\-standard\-2 \e
    \-\-accelerator\-type=NVIDIA_TESLA_V100 \-\-accelerator\-count=1 \e
    \-\-region=us\-central1 \-\-display\-name=my\-runtime\-template
.RE

To create a runtime template that disables end user credential access, run:

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



.SH "REQUIRED FLAGS"

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

The display name of the runtime template.


.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

Region resource \- Cloud region to create runtime template. 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\-template\-id\fR=\fIRUNTIME_TEMPLATE_ID\fR

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

.TP 2m

Configuration of the runtime template


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

The description of the runtime template.

.TP 2m
\fB\-\-enable\-euc\fR

Enable end user credential access for the runtime. Enabled by default, use
\fB\-\-no\-enable\-euc\fR to disable.

.TP 2m
\fB\-\-enable\-secure\-boot\fR

Enables secure boot for the runtime. Disabled by default.

.TP 2m
\fB\-\-idle\-shutdown\-timeout\fR=\fIIDLE_SHUTDOWN_TIMEOUT\fR; default="3h"

The duration after which the runtime is automatically shut down. An input of 0s
disables the idle shutdown feature, and a valid range is [10m, 24h]. See '$
gcloud topic datetimes' for details on formatting the input duration.

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

Add labels to identify and group the runtime template.

.TP 2m
\fB\-\-network\-tags\fR=[\fITAGS\fR,...]

Applies the given Compute Engine tags to the runtime.

.TP 2m

The machine configuration of the runtime.


.RS 2m
.TP 2m
\fB\-\-accelerator\-count\fR=\fIACCELERATOR_COUNT\fR

The number of accelerators used by the runtime.

.TP 2m
\fB\-\-accelerator\-type\fR=\fIACCELERATOR_TYPE\fR

The type of hardware accelerator used by the runtime. If specified,
\-\-accelerator\-count must also be specified. \fIACCELERATOR_TYPE\fR must be
one of: \fBNVIDIA_TESLA_V100\fR, \fBNVIDIA_TESLA_T4\fR, \fBNVIDIA_TESLA_A100\fR,
\fBNVIDIA_A100_80GB\fR, \fBNVIDIA_L4\fR.

.TP 2m
\fB\-\-machine\-type\fR=\fIMACHINE_TYPE\fR; default="e2\-standard\-4"

The Compute Engine machine type selected for the runtime.

.RE
.sp
.TP 2m

The configuration for the data disk of the runtime.


.RS 2m
.TP 2m
\fB\-\-disk\-size\-gb\fR=\fIDISK_SIZE_GB\fR; default=100

The disk size of the runtime in GB. If specified, the \-\-disk\-type must also
be specified. The minimum size is 10GB and the maximum is 65536GB.

.TP 2m
\fB\-\-disk\-type\fR=\fIDISK_TYPE\fR; default=\f5"PD_STANDARD"\fR

The type of the persistent disk. \fIDISK_TYPE\fR must be one of:
\fBPD_STANDARD\fR, \fBPD_SSD\fR, \fBPD_BALANCED\fR, \fBPD_EXTREME\fR.

.RE
.sp
.TP 2m

Key resource \- The Cloud KMS encryption key (customer\-managed encryption key)
used to protect the runtime. The key must be in the same region as the runtime.
If not specified, Google\-managed encryption keys will be used. The arguments in
this group can be used to specify the attributes of this resource.


.RS 2m
.TP 2m
\fB\-\-kms\-key\fR=\fIKMS_KEY\fR

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

To set the \f5kms\-key\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-kms\-key\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\-\-kms\-keyring\fR=\fIKMS_KEYRING\fR

KMS keyring id of the key.

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

.TP 2m
\fB\-\-kms\-location\fR=\fIKMS_LOCATION\fR

Cloud location for the key.

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

.TP 2m
\fB\-\-kms\-project\fR=\fIKMS_PROJECT\fR

Cloud project id for the key.

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

.RE
.sp
.TP 2m

The network configuration for the runtime.


.RS 2m
.TP 2m
\fB\-\-enable\-internet\-access\fR

Enable public internet access for the runtime. Enabled by default, use
\fB\-\-no\-enable\-internet\-access\fR to disable.

.TP 2m

Network resource \- The name of the VPC that this runtime is in. 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\-\-network\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


.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 "\(bu" 2m
provide the argument \f5\-\-network\fR on the command line.
.RE
.sp

.RE
.sp
.TP 2m

Subnetwork resource \- The name of the subnetwork that this runtime is in. 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 \f5\-\-subnetwork\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


.RS 2m
.TP 2m
\fB\-\-subnetwork\fR=\fISUBNETWORK\fR

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

To set the \f5subnetwork\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-subnetwork\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\-\-subnetwork\-region\fR=\fISUBNETWORK_REGION\fR

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

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


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



.SH "NOTES"

This variant is also available:

.RS 2m
$ gcloud beta colab runtime\-templates create
.RE