gcloud beta spanner instances move

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 instanceconfiguration.
EXAMPLES
To move the Cloud Spanner instance, which has two CMEK-enabled databases db1 anddb2 and a database db3 with Google-managed encryption keys, to the targetinstance configuration nam3 (us-east4, us-east1, us-central1), run:
gcloudbetaspannerinstancesmovemy-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 usedfor CMEK-enabled databases to specificy the target database KMS keys. Setstarget_database_move_configs value.
database-id
Required, setsdatabase-id value.
kms-key-names
Setskms-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 beta and might change without notice. Thesevariants are also available:
gcloudspannerinstancesmove
gcloudalphaspannerinstancesmove

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 2025-07-22 UTC.