gcloud beta colab runtime-templates create Stay organized with collections Save and categorize content based on your preferences.
- 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-templateTo 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-templateTo 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 the
projectattribute:- provide the argument
--regionon the command line with a fullyspecified name; - set the property
colab/regionwith a fully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
- provide the argument
--region=REGION- ID of the region or fully qualified identifier for the region.
To set the
regionattribute:- provide the argument
--regionon the command line; - set the property
colab/region.
- provide the argument
--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-eucto 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_TYPEmust 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_TYPEmust 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 the
kms-keyattribute:- provide the argument
--kms-keyon the command line.
This flag argument must be specified if any of the other arguments in this groupare specified.
- provide the argument
--kms-keyring=KMS_KEYRING- KMS keyring id of the key.
To set the
kms-keyringattribute:- provide the argument
--kms-keyon the command line with a fullyspecified name; - provide the argument
--kms-keyringon the command line.
- provide the argument
--kms-location=KMS_LOCATION- Cloud location for the key.
To set the
kms-locationattribute:- provide the argument
--kms-keyon the command line with a fullyspecified name; - provide the argument
--kms-locationon the command line.
- provide the argument
--kms-project=KMS_PROJECT- Cloud project id for the key.
To set the
kms-projectattribute:- provide the argument
--kms-keyon the command line with a fullyspecified name; - provide the argument
--kms-projecton the command line.
- provide the argument
- The network configuration for the runtime.
--enable-internet-access- Enable public internet access for the runtime. Enabled by default, use
--no-enable-internet-accessto 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 the
projectattribute:- provide the argument
--networkon the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
- provide the argument
--network=NETWORK- ID of the network or fully qualified identifier for the network.
To set the
networkattribute:- provide the argument
--networkon the command line.
- provide the argument
- 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 the
projectattribute:- provide the argument
--subnetworkon the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
- provide the argument
--subnetwork=SUBNETWORK- ID of the subnetwork or fully qualified identifier for the subnetwork.
To set the
subnetworkattribute:- provide the argument
--subnetworkon the command line.
This flag argument must be specified if any of the other arguments in this groupare specified.
- provide the argument
--subnetwork-region=SUBNETWORK_REGION- Google Cloud region of this subnetworkhttps://cloud.google.com/compute/docs/regions-zones/#locations.
To set the
subnetwork-regionattribute:- provide the argument
--subnetworkon the command line with a fullyspecified name; - provide the argument
--subnetwork-regionon the command line.
- provide the argument
- 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 helpfor 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.