gcloud beta colab runtime-templates create

NAME
gcloud beta colab runtime-templates create - create a runtime template
SYNOPSIS
gcloud beta colab runtime-templates create--display-name=DISPLAY_NAME[--async][--region=REGION][--runtime-template-id=RUNTIME_TEMPLATE_ID][--description=DESCRIPTION--no-enable-euc--enable-secure-boot--idle-shutdown-timeout=IDLE_SHUTDOWN_TIMEOUT; default="3h"--labels=[KEY=VALUE,…]--network-tags=[TAGS,…]--accelerator-count=ACCELERATOR_COUNT--accelerator-type=ACCELERATOR_TYPE--machine-type=MACHINE_TYPE; default="e2-standard-4"--disk-size-gb=DISK_SIZE_GB; default=100--disk-type=DISK_TYPE; default="PD_STANDARD" [--kms-key=KMS_KEY :--kms-keyring=KMS_KEYRING--kms-location=KMS_LOCATION--kms-project=KMS_PROJECT]--no-enable-internet-access--network=NETWORK [--subnetwork=SUBNETWORK :--subnetwork-region=SUBNETWORK_REGION]][GCLOUD_WIDE_FLAG]
DESCRIPTION
(BETA) Create a Colab Enterprise runtime template, a VMconfiguration for your notebook runtimes.
EXAMPLES
To create a runtime template in region 'us-central1' with the display name'my-runtime-template', run:
gcloudbetacolabruntime-templatescreate--region=us-central1--display-name=my-runtime-template

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

gcloudbetacolabruntime-templatescreate--machine-type=n1-standard-2--accelerator-type=NVIDIA_TESLA_V100--accelerator-count=1--region=us-central1--display-name=my-runtime-template

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

gcloudbetacolabruntime-templatescreate--no-enable-euc--region=us-central1--display-name=my-runtime-template
REQUIRED FLAGS
--display-name=DISPLAY_NAME
The display name of the runtime template.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
Region resource - Cloud region to create runtime template. Please seehttps://cloud.google.com/colab/docs/locationsfor a list of supported regions. This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--region on the command line with a fullyspecified name;
  • set the propertycolab/region with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.
--region=REGION
ID of the region or fully qualified identifier for the region.

To set theregion attribute:

  • provide the argument--region on the command line;
  • set the propertycolab/region.
--runtime-template-id=RUNTIME_TEMPLATE_ID
The id of the runtime template. If not specified, a random id will be generated.
Configuration of the runtime template
--description=DESCRIPTION
The description of the runtime template.
--enable-euc
Enable end user credential access for the runtime. Enabled by default, use--no-enable-euc to disable.
--enable-secure-boot
Enables secure boot for the runtime. Disabled by default.
--idle-shutdown-timeout=IDLE_SHUTDOWN_TIMEOUT; default="3h"
The duration after which the runtime is automatically shut down. An input of 0sdisables the idle shutdown feature, and a valid range is [10m, 24h]. See '$gcloud topic datetimes' fordetails on formatting the input duration.
--labels=[KEY=VALUE,…]
Add labels to identify and group the runtime template.
--network-tags=[TAGS,…]
Applies the given Compute Engine tags to the runtime.
The machine configuration of the runtime.
--accelerator-count=ACCELERATOR_COUNT
The number of accelerators used by the runtime.
--accelerator-type=ACCELERATOR_TYPE
The type of hardware accelerator used by the runtime. If specified,--accelerator-count must also be specified.ACCELERATOR_TYPE must be one of:NVIDIA_TESLA_V100,NVIDIA_TESLA_T4,NVIDIA_TESLA_A100,NVIDIA_A100_80GB,NVIDIA_L4.
--machine-type=MACHINE_TYPE; default="e2-standard-4"
The Compute Engine machine type selected for the runtime.
The configuration for the data disk of the runtime.
--disk-size-gb=DISK_SIZE_GB; default=100
The disk size of the runtime in GB. If specified, the --disk-type must also bespecified. The minimum size is 10GB and the maximum is 65536GB.
--disk-type=DISK_TYPE; default="PD_STANDARD"
The type of the persistent disk.DISK_TYPE must be oneof:PD_STANDARD,PD_SSD,PD_BALANCED,PD_EXTREME.
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 inthis group can be used to specify the attributes of this resource.
--kms-key=KMS_KEY
ID of the key or fully qualified identifier for the key.

To set thekms-key attribute:

  • provide the argument--kms-key on the command line.

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

--kms-keyring=KMS_KEYRING
KMS keyring id of the key.

To set thekms-keyring attribute:

  • provide the argument--kms-key on the command line with a fullyspecified name;
  • provide the argument--kms-keyring on the command line.
--kms-location=KMS_LOCATION
Cloud location for the key.

To set thekms-location attribute:

  • provide the argument--kms-key on the command line with a fullyspecified name;
  • provide the argument--kms-location on the command line.
--kms-project=KMS_PROJECT
Cloud project id for the key.

To set thekms-project attribute:

  • provide the argument--kms-key on the command line with a fullyspecified name;
  • provide the argument--kms-project on the command line.
The network configuration for the runtime.
--enable-internet-access
Enable public internet access for the runtime. Enabled by default, use--no-enable-internet-access to disable.
Network resource - The name of the VPC that this runtime is in. This representsa Cloud resource. (NOTE) Some attributes are not given arguments in this groupbut can be set in other ways.

To set theproject attribute:

  • provide the argument--network on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.
--network=NETWORK
ID of the network or fully qualified identifier for the network.

To set thenetwork attribute:

  • provide the argument--network on the command line.
Subnetwork resource - The name of the subnetwork that this runtime is in. Thearguments 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 inother ways.

To set theproject attribute:

  • provide the argument--subnetwork on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.
--subnetwork=SUBNETWORK
ID of the subnetwork or fully qualified identifier for the subnetwork.

To set thesubnetwork attribute:

  • provide the argument--subnetwork on the command line.

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

--subnetwork-region=SUBNETWORK_REGION
Google Cloud region of this subnetworkhttps://cloud.google.com/compute/docs/regions-zones/#locations.

To set thesubnetwork-region attribute:

  • provide the argument--subnetwork on the command line with a fullyspecified name;
  • provide the argument--subnetwork-region on the command line.
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$gcloud help for details.

NOTES
This command is currently in beta and might change without notice. This variantis also available:
gcloudcolabruntime-templatescreate

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-01-21 UTC.