mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-08 10:35:03 +00:00
87 lines
3 KiB
Text
87 lines
3 KiB
Text
NAME
|
|
gcloud alpha spanner instances create - create a Cloud Spanner instance
|
|
|
|
SYNOPSIS
|
|
gcloud alpha 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 ...]
|
|
|
|
DESCRIPTION
|
|
(ALPHA) Create a Cloud Spanner instance.
|
|
|
|
EXAMPLES
|
|
To create a Cloud Spanner instance, run:
|
|
|
|
$ gcloud alpha spanner instances create my-instance-id \
|
|
--config=regional-us-east1 \
|
|
--description=my-instance-display-name --nodes=3
|
|
|
|
POSITIONAL ARGUMENTS
|
|
INSTANCE
|
|
Cloud Spanner instance ID.
|
|
|
|
REQUIRED FLAGS
|
|
--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.
|
|
|
|
OPTIONAL FLAGS
|
|
--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.
|
|
|
|
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 this
|
|
command fails with API permission errors despite specifying the correct
|
|
project, you might be trying to access an API with an invitation-only early
|
|
access allowlist. These variants are also available:
|
|
|
|
$ gcloud spanner instances create
|
|
|
|
$ gcloud beta spanner instances create
|
|
|