1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 10:35:03 +00:00
gcloud-help/gcloud/alpha/spanner/instances/move
2025-05-14 10:45:02 +00:00

79 lines
3.2 KiB
Text

NAME
gcloud alpha spanner instances move - move the Cloud Spanner instance to
the specified instance configuration
SYNOPSIS
gcloud alpha spanner instances move INSTANCE --target-config=TARGET_CONFIG
[--target-database-move-configs=[^:^database-id=DATABASE_ID:kms-key-names=KEY1,
KEY2,...]] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Move the Cloud Spanner instance to the specified instance
configuration.
EXAMPLES
To move the Cloud Spanner instance, which has two CMEK-enabled databases
db1 and db2 and a database db3 with Google-managed encryption keys, to the
target instance configuration nam3 (us-east4, us-east1, us-central1), run: $ gcloud alpha spanner instances move my-instance-id \
--target-config=nam3 \
--target-database-move-configs=^:^database-id=db1:kms-key-names=\
projects/myproject/locations/us-east4/keyRings/mykeyring/\
cryptoKeys/cmek-key,projects/myproject/locations/us-east1/keyRings/\
mykeyring/cryptoKeys/cmek-key,projects/myproject/locations/\
us-central1/keyRings/mykeyring/cryptoKeys/cmek-key \
--target-database-move-configs=^:^database-id=db2:kms-key-names=\
projects/myproject/locations/us-east4/keyRings/mykeyring/\
cryptoKeys/cmek-key,projects/myproject/locations/us-east1/keyRings/\
mykeyring/cryptoKeys/cmek-key,projects/myproject/locations/\
us-central1/keyRings/mykeyring/cryptoKeys/cmek-key
POSITIONAL ARGUMENTS
INSTANCE
Cloud Spanner instance ID.
REQUIRED FLAGS
--target-config=TARGET_CONFIG
Target Instance configuration to move the instances.
OPTIONAL FLAGS
--target-database-move-configs=[^:^database-id=DATABASE_ID:kms-key-names=KEY1,KEY2,...]
Database level configurations for each database to be moved. Currently
only used for CMEK-enabled databases to specificy the target database
KMS keys. Sets target_database_move_configs value.
database-id
Required, sets database-id value.
kms-key-names
Sets kms-key-names value.
Shorthand Example:
--target-database-move-configs=database-id=string,kms-key-names=string --target-database-move-configs=database-id=string,kms-key-names=string
JSON Example:
--target-database-move-configs='[{"database-id": "string", "kms-key-names": "string"}]'
File Example:
--target-database-move-configs=path_to_file.(yaml|json)
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 move
$ gcloud beta spanner instances move