gcloud alpha bigtable clusters create

NAME
gcloud alpha bigtable clusters create - create a bigtable cluster
SYNOPSIS
gcloud alpha bigtable clusters create(CLUSTER :--instance=INSTANCE)--zone=ZONE[--async][--node-scaling-factor=NODE_SCALING_FACTOR; default="node-scaling-factor-1x"][--kms-key=KMS_KEY :--kms-keyring=KMS_KEYRING--kms-location=KMS_LOCATION--kms-project=KMS_PROJECT][--num-nodes=NUM_NODES; default=3    | [--autoscaling-cpu-target=AUTOSCALING_CPU_TARGET--autoscaling-max-nodes=AUTOSCALING_MAX_NODES--autoscaling-min-nodes=AUTOSCALING_MIN_NODES :--autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET]][GCLOUD_WIDE_FLAG]
DESCRIPTION
(ALPHA) Create a bigtable cluster.
EXAMPLES
To add a cluster in zoneus-east1-c to the instance with idmy-instance-id, run:
gcloudalphabigtableclusterscreatemy-cluster-id--instance=my-instance-id--zone=us-east1-c

To add a cluster with10 nodes, run:

gcloudalphabigtableclusterscreatemy-cluster-id--instance=my-instance-id--zone=us-east1-c--num-nodes=10
POSITIONAL ARGUMENTS
Cluster resource - The cluster to describe. The arguments in this group can beused to specify the attributes of this resource. (NOTE) Some attributes are notgiven arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argumentcluster on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

CLUSTER
ID of the cluster or fully qualified identifier for the cluster.

To set thecluster attribute:

  • provide the argumentcluster on the command line.

This positional argument must be specified if any of the other arguments in thisgroup are specified.

--instance=INSTANCE
Bigtable instance for the cluster.

To set theinstance attribute:

  • provide the argumentcluster on the command line with a fullyspecified name;
  • provide the argument--instance on the command line.
REQUIRED FLAGS
--zone=ZONE
ID of the zone where the cluster is located. Supported zones are listed athttps://cloud.google.com/bigtable/docs/locations.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
--node-scaling-factor=NODE_SCALING_FACTOR; default="node-scaling-factor-1x"
Node scaling factor for the cluster.NODE_SCALING_FACTORmust be one of:node-scaling-factor-1x,node-scaling-factor-2x.
Key resource - The Cloud KMS (Key Management Service) cryptokey that will beused to protect the cluster. The arguments in this group can be used to specifythe 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
The 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
The 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
The 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.
At most one of these can be specified:
Manual Scaling
--num-nodes=NUM_NODES; default=3
Number of nodes to serve.
Autoscaling
--autoscaling-cpu-target=AUTOSCALING_CPU_TARGET
The target CPU utilization percentage for autoscaling. Accepted values are from10 to 80.

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

--autoscaling-max-nodes=AUTOSCALING_MAX_NODES
The maximum number of nodes for autoscaling.

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

--autoscaling-min-nodes=AUTOSCALING_MIN_NODES
The minimum number of nodes for autoscaling.

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

--autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET
The target storage utilization gibibytes per node for autoscaling. Acceptedvalues are from 2560 to 5120 for SSD clusters and 8192 to 16384 for HDDclusters.
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 alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudbigtableclusterscreate
gcloudbetabigtableclusterscreate

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.