gcloud spanner instances create - create a Cloud Spanner instance
gcloud spanner instances create INSTANCE --config=CONFIG --description=DESCRIPTION [--async] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...]
Create a Cloud Spanner instance.
To create a Cloud Spanner instance, run:
$ gcloud spanner instances create my-instance-id \ --config=regional-us-east1 \ --description=my-instance-display-name --nodes=3
- INSTANCE
Cloud Spanner instance ID.
- --config=CONFIG
Instance configuration defines the geographic placement and replication of the databases in that instance. Available configurations can be found by running "gcloud spanner instance-configs list"
- --description=DESCRIPTION
Description of the instance.
- --async
Return immediately, without waiting for the operation in progress to complete.
- --expire-behavior=EXPIRE_BEHAVIOR
The expire behavior of a free trial instance. EXPIRE_BEHAVIOR must be one of:
- free-to-provisioned
When the free trial instance expires, upgrade the instance to a provisioned instance.
- remove-after-grace-period
When the free trial instance expires, disable the instance, and delete it after the grace period passes if it has not been upgraded to a provisioned instance.
- --instance-type=INSTANCE_TYPE
Specifies the type for this instance. INSTANCE_TYPE must be one of:
- free-instance
Free trial instances provide no guarantees for dedicated resources, both node_count and processing_units should be 0. They come with stricter usage limits and limited support.
- provisioned
Provisioned instances have dedicated resources, standard usage limits, and support.
- At most one of these can be specified:
- --nodes=NODES
Number of nodes for the instance.
- --processing-units=PROCESSING_UNITS
Number of processing units for the instance.
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.
These variants are also available:
$ gcloud alpha spanner instances create
$ gcloud beta spanner instances create