gcloud spanner instance-partitions create

NAME
gcloud spanner instance-partitions create - create a Spanner instance partition
SYNOPSIS
gcloud spanner instance-partitions create(INSTANCE_PARTITION :--instance=INSTANCE)--config=CONFIG--description=DESCRIPTION[--async][--nodes=NODES    |--processing-units=PROCESSING_UNITS    |--autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET (--autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET--autoscaling-total-cpu-target=AUTOSCALING_TOTAL_CPU_TARGET) (--autoscaling-max-nodes=AUTOSCALING_MAX_NODES--autoscaling-min-nodes=AUTOSCALING_MIN_NODES |--autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS--autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS)][GCLOUD_WIDE_FLAG]
DESCRIPTION
Create a Spanner instance partition.
EXAMPLES
To create a Spanner instance partition, run:
gcloudspannerinstance-partitionscreatemy-instance-partition-id--instance=my-instance-id--config=regional-us-east1--description=my-instance-display-name--nodes=3
POSITIONAL ARGUMENTS
Instance partition resource - The Spanner instance partition 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 theproject attribute:

  • provide the argumentinstance_partition on the command line with afully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

INSTANCE_PARTITION
ID of the instance partition or fully qualified identifier for the instancepartition.

To set theinstance partition attribute:

  • provide the argumentinstance_partition on the command line.

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

--instance=INSTANCE
The Cloud Spanner instance for the instance partition.

To set theinstance attribute:

  • provide the argumentinstance_partition on the command line with afully specified name;
  • provide the argument--instance on the command line;
  • set the propertyspanner/instance.
REQUIRED FLAGS
--config=CONFIG
Instance configuration defines the geographic placement and replication used bythe instance partition. Available configurations can be found by running "gcloudspanner instance-configs list"
--description=DESCRIPTION
Description of the instance partition.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
At most one of these can be specified:
--nodes=NODES
Number of nodes for the instance partition.
--processing-units=PROCESSING_UNITS
Number of processing units for the instance partition.
Or at least one of these can be specified:
Autoscaling
--autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET
Specifies the target percentage of storage the autoscaled instance can utilize.

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

Autoscaling CPU targets.

At least one of these must be specified:

--autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET
Specifies the target percentage of high-priority CPU the autoscaled instance canutilize.
--autoscaling-total-cpu-target=AUTOSCALING_TOTAL_CPU_TARGET
Specifies the target percentage of total CPU the autoscaled instance canutilize.
Autoscaling limits can be defined in either nodes or processing units.

Exactly one of these must be specified:

Autoscaling limits in nodes:
--autoscaling-max-nodes=AUTOSCALING_MAX_NODES
Maximum number of nodes for the autoscaled instance.

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

--autoscaling-min-nodes=AUTOSCALING_MIN_NODES
Minimum number of nodes for the autoscaled instance.

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

Autoscaling limits in processing units:
--autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS
Maximum number of processing units for the autoscaled instance.

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

--autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS
Minimum number of processing units for the autoscaled instance.

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

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
These variants are also available:
gcloudalphaspannerinstance-partitionscreate
gcloudbetaspannerinstance-partitionscreate

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-02-18 UTC.