- NAME
-
- gcloud beta spanner instances move - move the Cloud Spanner instance to the specified instance configuration
- SYNOPSIS
-
-
gcloud beta spanner instances moveINSTANCE--target-config=TARGET_CONFIG[--target-database-move-configs=[^:^database-id=DATABASE_ID:kms-key-names=KEY1,KEY2, …]] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)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 beta 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_configsvalue.-
database-id - Required, sets
database-idvalue. -
kms-key-names - Sets
kms-key-namesvalue.
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 helpfor details. - NOTES
- This command is currently in beta and might change without notice. These
variants are also available:
gcloud spanner instances movegcloud alpha spanner instances move
gcloud beta spanner instances move
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.
