gcloud workstations clusters create Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud workstations clusters create - create a workstation cluster
- SYNOPSIS
gcloud workstations clusters create(CLUSTER:--region=REGION)[--async][--domain=DOMAIN][--enable-private-endpoint][--labels=[KEY=VALUE,…]][--network=NETWORK][--subnetwork=SUBNETWORK][--tags=[KEY=VALUE,…]][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
- Create a workstation cluster.
- EXAMPLES
- To create a public cluster
my-clusterin regionus-central1, run:gcloudworkstationsclusterscreatemy-cluster--region=us-central1To create a private cluster 'my-private-cluster' associated with network'my-network' and subnetwork 'my-subnetwork'. run:
gcloudworkstationsclusterscreatemy-private-cluster--region=us-central1--enable-private-endpoint--network='my-network'--subnetwork='my-subnetwork' - POSITIONAL ARGUMENTS
- Cluster resource - Arguments and flags that specify the cluster to create. 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
clusteron the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
This must be specified.
CLUSTER- ID of the cluster or fully qualified identifier for the cluster.
To set the
clusterattribute:- provide the argument
clusteron the command line.
This positional argument must be specified if any of the other arguments in thisgroup are specified.
- provide the argument
--region=REGION- The name of the region of the cluster.To set the
regionattribute:- provide the argument
clusteron the command line with a fullyspecified name; - provide the argument
--regionon the command line; - set the property
workstations/region.
- provide the argument
- provide the argument
- Cluster resource - Arguments and flags that specify the cluster to create. 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.
- FLAGS
--async- Return immediately, without waiting for the operation in progress to complete.
--domain=DOMAIN- Domain used by Workstations for HTTP ingress.
--enable-private-endpoint- Default is false. If specified, the cluster will be assigned an internal IPaddress to the Cluster Gateway. This isolates the cluster's workstations frompublic networks, but requires additional configuration. Learn more:https://cloud.google.com/workstations/docs.
--labels=[KEY=VALUE,…]- Labels that are applied to the cluster and propagated to the underlying ComputeEngine resources.
--network=NETWORK- Fully specified network path for instances created in this cluster.
--subnetwork=SUBNETWORK- Fully specified subnetwork path for instances created in this cluster.
--tags=[KEY=VALUE,…]- Resource manager tags to be bound to this cluster. For example:"123/environment=production" "123/costCenter=marketing"
- 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. - API REFERENCE
- This command uses the
workstations/v1API. The full documentationfor this API can be found at:https://cloud.google.com/workstations - NOTES
- These variants are also available:
gcloudalphaworkstationsclusterscreategcloudbetaworkstationsclusterscreate
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 2025-05-13 UTC.