En esta página, se describe cómo usar claves de encriptación administradas por el cliente (CMEK) creadas de forma manual para Spanner.
Para obtener más información sobre las CMEK, consulta la descripción general de las claves de encriptación administradas por el cliente (CMEK).
Crea una base de datos habilitada con CMEK
Crea una clave en Cloud Key Management Service (Cloud KMS). Puedes usar los siguientes tipos de claves que tienen diferentes niveles de protección en Spanner:
La clave debe estar en la misma ubicación que tu instancia de Spanner. Por ejemplo, si la configuración de tu instancia de Spanner está en
us-west1, la ubicación del llavero de claves de Cloud KMS también debe serus-west1.No todas las configuraciones de instancias multirregionales de Spanner tienen una ubicación de llavero de claves de Cloud KMS correspondiente. Para las bases de datos de Spanner en parámetros de configuración de instancias personalizados, birregionales o multirregionales, puedes usar varias claves de Cloud KMS regionales (de una sola región) para proteger tu base de datos. Por ejemplo:
- Si tu base de datos de Spanner está en la configuración de instancia multirregional
nam14, puedes crear claves de Cloud KMS enus-east4,northamerica-northeast1yus-east1. - Si tu base de datos se encuentra en una configuración de instancia personalizada que usa
nam3como la configuración de instancia base con una réplica de solo lectura adicional enus-central2, puedes crear claves de Cloud KMS enus-east4,us-east1,us-central1yus-central2.
Opcional: Para ver una lista de las ubicaciones de las réplicas en la configuración de tu instancia de Spanner, usa el comando
gcloud spanner instances get-locations:gcloud spanner instances get-locations <var>INSTANCE_ID</var>Para obtener más información, consulta los siguientes recursos:
- Si tu base de datos de Spanner está en la configuración de instancia multirregional
Otorga acceso a Spanner a la clave.
En Cloud Shell, crea y muestra el agente de servicio, o muéstralo si la cuenta ya existe:
gcloud beta services identity create --service=spanner.googleapis.com \ --project=PROJECT_IDSi se te solicita que instales el componente Comandos Beta de gcloud, escribe
Y. Después de la instalación, el comando se reinicia de forma automática.El comando
gcloud services identitycrea o obtiene el agente de servicio que Spanner puede usar para acceder a la clave de Cloud KMS en tu nombre.El ID de la cuenta de servicio tiene el formato de una dirección de correo electrónico:
Service identity created: service-xxx@gcp-sa-spanner.Otorga el rol de encriptador/desencriptador de CryptoKey de Cloud KMS (
cloudkms.cryptoKeyEncrypterDecrypter) a la cuenta de servicio para cada región (--location) en la configuración de la instancia de Spanner. Para ello, ejecuta el comandogcloud kms keys add-iam-policybinding:gcloud kms keys add-iam-policy-binding KMS_KEY \ --location KMS_KEY_LOCATION \ --keyring KMS_KEY_RING \ --project=PROJECT_ID \ --member serviceAccount:service-xxx@gcp-sa-spanner. \ --role roles/cloudkms.cryptoKeyEncrypterDecrypterEste es un ejemplo del resultado:
Updated IAM policy for key [KMS_KEY]Si usas varias claves de Cloud KMS para proteger tu base de datos, ejecuta el comando
gcloud kms keys add-iam-policybindingpara todas tus claves.Este rol garantiza que la cuenta de servicio tenga permiso para encriptar y desencriptar con la clave de Cloud KMS. Para obtener más información, consulta Permisos y roles de Cloud KMS.
Crea la base de datos y especifica tu clave de Cloud KMS.
Console
Usa la consola para crear bases de datos en configuraciones de instancias regionales.
En la consola de Google Cloud , ve a la página Instancias.
Haz clic en la instancia en la que deseas crear una base de datos.
Haz clic en Crear base de datos y completa los campos obligatorios.
Haz clic en Mostrar opciones de encriptación.
Selecciona Clave de Cloud KMS.
Selecciona una clave de la lista desplegable.
La lista de claves se limita al proyecto de Google Cloud actual. Para usar una clave de un proyecto de Google Cloud diferente, crea la base de datos con gcloud CLI en lugar de la consola deGoogle Cloud .
Una vez que se cree la base de datos, puedes verificar que esté habilitada para CMEK en la página Descripción general de la base de datos.

gcloud
Para crear una base de datos habilitada para CMEK en una configuración de instancia regional, personalizada o multirregional, ejecuta el comando gcloud spanner databases create:
gcloud spanner databases create DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--ddl="CREATE TABLE Users (Id INT64 NOT NULL, FirstName STRING(100) NOT NULL, LastName STRING(100) NOT NULL,) PRIMARY KEY (Id)" \
--kms-project=KMS_PROJECT_ID \
--kms-location=KMS_KEY_LOCATION \
--kms-keyring=KMS_KEYRING \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]Para verificar que una base de datos tenga habilitada la CMEK, ejecuta el comando
gcloud spanner databases describe:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDLas bases de datos habilitadas para CMEK incluyen un campo para encryptionConfig, como se muestra en el
siguiente resultado de ejemplo:
encryptionConfig:
kmsKeyNames:projects/my-kms-project/locations/eur5/keyRings/my-kms-key-ring/cryptoKeys/my-kms-key
name: projects/my-spanner-project/instances/my-instance/databases/my-db
state: READY
Bibliotecas cliente
C#
Para crear una base de datos habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una base de datos habilitada para CMEK en una configuración de instancia multirregional, sigue estos pasos:
C++
Para crear una base de datos habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una base de datos habilitada para CMEK en una configuración de instancia multirregional, sigue estos pasos:
Go
Para crear una base de datos habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una base de datos habilitada para CMEK en una configuración de instancia multirregional, sigue estos pasos:
Java
Para crear una base de datos habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una base de datos habilitada para CMEK en una configuración de instancia multirregional, sigue estos pasos:
Node.js
Para crear una base de datos habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una base de datos habilitada para CMEK en una configuración de instancia multirregional, sigue estos pasos:
PHP
Para crear una base de datos habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una base de datos habilitada para CMEK en una configuración de instancia multirregional, sigue estos pasos:
Python
Para crear una base de datos habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una base de datos habilitada para CMEK en una configuración de instancia multirregional, sigue estos pasos:
Ruby
Para crear una base de datos habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una base de datos habilitada para CMEK en una configuración de instancia multirregional, sigue estos pasos:
Cambia la configuración de encriptación de la base de datos
Puedes cambiar la configuración de encriptación de una base de datos de Spanner existente sin tiempo de inactividad con gcloud CLI, la API de REST o la API de RPC. Puedes realizar los siguientes cambios en la configuración de encriptación en una base de datos existente:
- Habilita CMEK en una base de datos que use Google-owned and Google-managed encryption key.
- Cambiar las claves de Cloud KMS en una base de datos habilitada para CMEK, lo que incluye cambiar entre una clave multirregional y varias claves regionales, o reemplazar una o más claves regionales. Reemplazar cualquier clave regional vuelve a encriptar todos los datos de la base de datos, no solo los de esa región.
- Quita la CMEK y revierte una base de datos a Google-owned and Google-managed encryption key.
Durante la nueva encriptación en segundo plano, es posible que una pequeña cantidad de transacciones falle
con un error ABORTED que se puede reintentar. Las bibliotecas cliente de Spanner reintentan
estas transacciones automáticamente. Si usas la API de REST o RPC directamente,
reintenta estas transacciones en tu aplicación.
Cambiar de una sola clave multirregional a varias claves regionales modifica el comportamiento de la revocación de claves. Inhabilitar una sola clave o todas las claves regionales a la vez, suele hacer que la base de datos no esté disponible en un plazo de una hora. Si inhabilitas solo un subconjunto de claves regionales, la base de datos podría tardar hasta 24 horas en volverse inaccesible. Para obtener más información, consulta Inhabilita la clave.
Habilita CMEK o cambia las claves de Cloud KMS
Para habilitar las CMEK en una base de datos existente o cambiar las claves de Cloud KMS en una base de datos habilitada para CMEK, completa los siguientes pasos:
Crea tus claves de Cloud KMS de destino en las ubicaciones requeridas y otorga el rol de encriptador/desencriptador de CryptoKey de Cloud KMS (
roles/cloudkms.cryptoKeyEncrypterDecrypter) en cada clave de destino al agente de servicio de Spanner de tu proyecto, como se describe en los pasos 1 y 2 de Crea una base de datos habilitada para CMEK.Actualiza la configuración de encriptación de la base de datos:
gcloud
Ejecuta el comando
gcloud spanner databases updatey especifica los nombres de recursos completamente calificados de tus claves de Cloud KMS de destino con la marca--kms-keys.Para una clave de una sola región o multirregional, haz lo siguiente:
gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --kms-keys="projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KMS_KEY"En el caso de varias claves regionales en una configuración de instancia personalizada, birregional o multirregional, especifica una lista separada por comas que contenga el conjunto completo de nombres de recursos de claves de Cloud KMS requeridos para todas las regiones de tu configuración de instancia, incluso si solo reemplazas un subconjunto de las claves:
gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --kms-keys="projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_1/keyRings/KMS_KEY_RING_1/cryptoKeys/KMS_KEY_1,projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_2/keyRings/KMS_KEY_RING_2/cryptoKeys/KMS_KEY_2,projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_3/keyRings/KMS_KEY_RING_3/cryptoKeys/KMS_KEY_3"REST
Llama al método
projects.instances.databases.patchconupdateMask=encryption_configy especifica tuencryptionConfigde destino.Para una clave de una sola región o multirregional, haz lo siguiente:
PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": { "kmsKeyNames": [ "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KMS_KEY" ] } }En el caso de varias claves regionales en una configuración de instancia personalizada, birregional o multirregional, especifica un array que contenga el conjunto completo de nombres de recursos de claves de Cloud KMS requeridos para todas las regiones de tu configuración de instancia, incluso si solo reemplazas un subconjunto de las claves:
PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": { "kmsKeyNames": [ "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_1/keyRings/KMS_KEY_RING_1/cryptoKeys/KMS_KEY_1", "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_2/keyRings/KMS_KEY_RING_2/cryptoKeys/KMS_KEY_2", "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_3/keyRings/KMS_KEY_RING_3/cryptoKeys/KMS_KEY_3" ] } }Espera hasta que finalice la nueva encriptación en segundo plano antes de volver a cambiar la configuración de encriptación de la base de datos o antes de inhabilitar, revocar o destruir cualquier clave de Cloud KMS anterior. También conserva las claves si es posible que las necesites para restablecer desde copias de seguridad. Para determinar si se completó la reencriptación en segundo plano, consulta Verifica que se haya completado la reencriptación en segundo plano.
Revierte una base de datos a Google-owned and Google-managed encryption key
Para quitar la CMEK de una base de datos existente y revertirla a Google-owned and Google-managed encryption key, completa los siguientes pasos:
Actualiza la configuración de encriptación de la base de datos para borrar sus claves de Cloud KMS:
gcloud
Ejecuta el comando
gcloud spanner databases updatecon la marca--clear-kms-keys:gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --clear-kms-keysREST
Llama al método
projects.instances.databases.patchconupdateMask=encryption_configy unencryptionConfigvacío:PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": {} }Espera hasta que finalice la nueva encriptación en segundo plano antes de volver a cambiar la configuración de encriptación de la base de datos o antes de inhabilitar, revocar o destruir cualquier clave de Cloud KMS anterior. También conserva las claves si es posible que las necesites para restablecer desde copias de seguridad. Para determinar si se completó la reencriptación en segundo plano, consulta Verifica que se haya completado la reencriptación en segundo plano.
Verifica que se haya completado la reencriptación en segundo plano
La operación de actualización de la base de datos se completa cuando se guarda la nueva encryptionConfig,
mientras que Spanner vuelve a encriptar los datos existentes de la base de datos
de forma asíncrona en segundo plano. La nueva encriptación en segundo plano puede tardar varias
horas. Cambiar o quitar claves lleva más tiempo que agregar CMEK, y las bases de datos más grandes pueden tardar más.
Para verificar el estado de la nueva encriptación en segundo plano, ejecuta el comando
gcloud spanner databases describe:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--format="yaml(encryptionConfig,encryptionInfo)"Usa el resultado de encryptionInfo para determinar si se completó la reencriptación en segundo plano:
- Cambia las claves de Cloud KMS: Mientras se vuelve a encriptar en segundo plano,
encryptionInfoenumera las versiones de claves de Cloud KMS anteriores y actualizadas. La reencriptación se completa cuandoencryptionInfoenumera solo las versiones de claves que pertenecen a las claves de destino enencryptionConfig. En el caso de las bases de datos con varias claves regionales, las versiones de claves anteriores abandonanencryptionInfouna región a la vez, por lo que debes esperar hasta que ninguna entrada haga referencia a una versión de clave anterior. - Revertir a Google-owned and Google-managed encryption key: Mientras se vuelve a encriptar en segundo plano,
encryptionInfosigue mostrando las versiones anteriores de la clave de Cloud KMS. La nueva encriptación se completa cuandoencryptionInfoya no muestra ninguna entradaCUSTOMER_MANAGED_ENCRYPTION. - Habilitar CMEK en una base de datos que usaba Google-owned and Google-managed encryption key:
encryptionInfopodría estar vacío durante unos minutos después del cambio. Luego, enumera las versiones nuevas de la clave de Cloud KMS después de que se usan, lo que puede aparecer antes de que todos los datos preexistentes protegidos por Google-owned and Google-managed encryption key hayan terminado de volver a encriptarse en segundo plano.encryptionInfono indica cuándo finaliza la reencriptación de los datos preexistentes.
Visualiza las versiones de clave en uso
El campo encryption_info
de la base de datos muestra información sobre las versiones de las claves.
Cuando se rota una versión de clave en Cloud KMS, encryption_info se actualiza una vez
que se usa la versión nueva. Cuando cambias la configuración de encriptación de la base de datos, encryption_info enumera las versiones de clave que aún están en uso, que pueden incluir las versiones de clave anteriores, hasta que se complete la reencriptación en segundo plano. Para obtener más información, consulta
Verifica que se haya completado la reencriptación en segundo plano.
Console
En la consola de Google Cloud , ve a la página Instancias.
Haz clic en la instancia que contiene la base de datos que quieres ver.
Haz clic en la base de datos.
La información de encriptación se muestra en la página Detalles de la base de datos.

gcloud
Puedes obtener el encryption_info de una base de datos ejecutando el comando
gcloud spanner databases describe
o gcloud spanner databases list. Por ejemplo:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDEste es un ejemplo del resultado:
name: projects/my-project/instances/test-instance/databases/example-db
encryptionInfo:
- encryptionType: CUSTOMER_MANAGED_ENCRYPTION
kmsKeyVersion: projects/my-kms-project/locations/my-kms-key1-location/keyRings/my-kms-key-ring1/cryptoKeys/my-kms-key1/cryptoKeyVersions/1
- encryptionType: CUSTOMER_MANAGED_ENCRYPTION
kmsKeyVersion: projects/my-kms-project/locations/my-kms-key2-location/keyRings/my-kms-key-ring2/cryptoKeys/my-kms-key2/cryptoKeyVersions/1
Inhabilita la clave
Inhabilita las versiones de clave que están en uso siguiendo estas instrucciones para cada versión de clave.
Espera a que se aplique el cambio. La inhabilitación de una clave puede tardar hasta tres horas en propagarse.
Para confirmar que ya no se puede acceder a la base de datos, ejecuta una consulta en la base de datos con CMEK inhabilitada:
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'Aparecerá el siguiente mensaje de error:
KMS key required by the Spanner resource is not accessible.
Habilita la clave
Sigue estas instrucciones para cada versión de clave y habilita las versiones de clave que usa la base de datos.
Espera a que se aplique el cambio. La habilitación de una clave puede tardar hasta tres horas en propagarse.
Para confirmar que ya no se puede acceder a la base de datos, ejecuta una consulta en la base de datos habilitada para CMEK:
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'Si el cambio se aplicó, el comando se ejecuta correctamente.
Crea una copia de seguridad de una base de datos
Puedes usar las copias de seguridad de Spanner para crear copias de seguridad de tus bases de datos. De forma predeterminada, las copias de seguridad de Spanner creadas a partir de una base de datos usan la misma configuración de encriptación que la base de datos. De manera opcional, puedes especificar una configuración de encriptación diferente para una copia de seguridad.
Si una base de datos usa varias claves regionales de Cloud KMS, sus copias de seguridad solo enumeran las claves de las regiones que almacenan datos. La clave de la región testigo no aparece en la lista porque las réplicas testigo no almacenan datos de copia de seguridad.
Console
Usa la consola para crear copias de seguridad en parámetros de configuración de instancias regionales.
En la consola de Google Cloud , ve a la página Instancias.
Haz clic en el nombre de la instancia que contiene la base de datos de la que deseas crear una copia de seguridad.
Haz clic en la base de datos.
En el panel de navegación, haz clic en Copia de seguridad y restablecimiento.
En la pestaña Copias de seguridad, haz clic en Crear copia de seguridad.
Ingresa un nombre para la copia de seguridad y selecciona una fecha de vencimiento.
Opcional: Haz clic en Mostrar opciones de encriptación.
a. Si deseas usar una configuración de encriptación diferente para tu copia de seguridad, haz clic en el control deslizante junto a Usar la encriptación existente.
a. Selecciona Clave de Cloud KMS.
a. Selecciona una clave de la lista desplegable.
La lista de claves se limita al proyecto de Google Cloud actual. Para usar una clave de un proyecto de Google Cloud diferente, crea la base de datos con gcloud CLI en lugar de la consola de Google Cloud .
Haz clic en Crear.
En la tabla Copias de seguridad, se muestra la información de encriptación de cada copia de seguridad.

gcloud
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia regional, personalizada o multirregional, ejecuta el comando gcloud spanner backups create:
gcloud spanner backups create BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--database=DATABASE \
--retention-period=RETENTION_PERIOD \
--encryption-type=customer_managed_encryption \
--kms-project=KMS_PROJECT_ID \
--kms-location=KMS_KEY_LOCATION \
--kms-keyring=KMS_KEY_RING \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]
--asyncPara verificar que la copia de seguridad creada esté encriptada con CMEK, haz lo siguiente:
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDBibliotecas cliente
C#
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
C++
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Go
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Java
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Node.js
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
PHP
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Python
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Ruby
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para crear una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Copia una copia de seguridad
Puedes copiar una copia de seguridad de tu base de datos de Spanner de una instancia a otra en una región o un proyecto diferentes. De forma predeterminada, una copia de seguridad copiada usa la misma configuración de encriptación, ya sea administrada por Google o por el cliente, que la encriptación de la copia de seguridad de origen. Puedes anular este comportamiento si especificas una configuración de encriptación diferente cuando copias la copia de seguridad. Si deseas que la copia de seguridad se encripte con CMEK cuando se copie entre regiones, especifica las claves de Cloud KMS que correspondan a las regiones de destino.
Console
Usa la consola para copiar una copia de seguridad en una configuración de instancia regional.
En la consola de Google Cloud , ve a la página Instancias.
Haz clic en el nombre de la instancia que contiene la base de datos de la que deseas crear una copia de seguridad.
Haz clic en la base de datos.
En el panel de navegación, haz clic en Copia de seguridad y restablecimiento.
En la tabla Copias de seguridad, selecciona Acciones para tu copia de seguridad y haz clic en Copiar.
Completa el formulario eligiendo una instancia de destino, proporcionando un nombre y seleccionando una fecha de vencimiento para la copia de seguridad.
Opcional: Si quieres usar una configuración de encriptación diferente para tu copia de seguridad, haz clic en Mostrar opciones de encriptación.
a. Selecciona Clave de Cloud KMS.
a. Selecciona una clave de la lista desplegable.
La lista de claves se limita al proyecto de Google Cloud actual. Para usar una clave de un proyecto de Google Cloud diferente, crea la base de datos con gcloud CLI en lugar de la consola de Google Cloud .
Haz clic en Copiar.
gcloud
Para copiar una copia de seguridad, con una configuración de encriptación nueva, en una instancia diferente
en el mismo proyecto, ejecuta el siguiente comando
gcloud spanner backups copy:
gcloud spanner backups copy --async \
--source-instance=INSTANCE_ID \
--source-backup=SOURCE_BACKUP_NAME \
--destination-instance=DESTINATION_INSTANCE_ID \
--destination-backup=DESTINATION_BACKUP_NAME \
--expiration-date=EXPIRATION_DATE \
--encryption-type=CUSTOMER_MANAGED_ENCRYPTION \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]Para copiar una copia de seguridad, con una configuración de encriptación nueva, en una instancia diferente
en un proyecto diferente, ejecuta el siguiente comando
gcloud spanner backups copy:
gcloud spanner backups copy --async \
--source-backup=SOURCE_BACKUP_NAME \
--destination-backup=DESTINATION_BACKUP_NAME \
--encryption-type=CUSTOMER_MANAGED_ENCRYPTION \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]Para verificar que la copia de seguridad copiada esté encriptada con CMEK, haz lo siguiente:
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDBibliotecas cliente
C#
Para copiar una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
C++
Para copiar una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Go
Para copiar una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Java
Para copiar una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Node.js
Para copiar una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
PHP
Para copiar una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Python
Para copiar una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Ruby
Para copiar una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Restablecer copia de seguridad
Puedes restablecer una copia de seguridad de una base de datos de Spanner en una base de datos nueva. De forma predeterminada, las bases de datos que se restablecen a partir de una copia de seguridad usan la misma configuración de encriptación que la copia de seguridad, pero puedes anular este comportamiento si especificas una configuración de encriptación diferente para la base de datos restablecida. Si la copia de seguridad está protegida por CMEK, la versión de la clave que se usó para crear la copia de seguridad debe estar disponible para que se pueda desencriptar.
Console
Usa la consola para restablecer una copia de seguridad en una configuración de instancia regional.
En la consola de Google Cloud , ve a la página Instancias.
Haz clic en la instancia que contiene la base de datos que deseas restablecer.
Haz clic en la base de datos.
En el panel de navegación, haz clic en Copia de seguridad y restablecimiento.
En la tabla Copias de seguridad, selecciona Acciones para tu copia de seguridad y haz clic en Restablecer.
Selecciona la instancia que deseas restablecer y asigna un nombre a la base de datos restablecida.
Opcional: Si quieres usar una configuración de encriptación diferente con tu base de datos restablecida, haz clic en el control deslizante junto a Usar la encriptación existente.
a. Selecciona Clave de Cloud KMS.
a. Selecciona una clave de la lista desplegable.
La lista de claves se limita al proyecto de Google Cloud actual. Para usar una clave de un proyecto de Google Cloud diferente, crea la base de datos con gcloud CLI en lugar de la consola de Google Cloud .
Haz clic en Restablecer.
gcloud
Para restablecer una copia de seguridad con una configuración de encriptación nueva, ejecuta el siguiente comando de
gcloud spanner databases restore:
gcloud spanner databases restore --async \
--project=SPANNER_PROJECT_ID \
--destination-instance=DESTINATION_INSTANCE_ID \
--destination-database=DESTINATION_DATABASE_ID \
--source-instance=SOURCE_INSTANCE_ID \
--source-backup=SOURCE_BACKUP_NAMEPara verificar que la base de datos restablecida esté encriptada con CMEK, haz lo siguiente:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDPara obtener más información, consulta Restablece desde una copia de seguridad.
Bibliotecas cliente
C#
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
C++
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Go
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Java
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Node.js
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
PHP
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Python
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Ruby
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia regional, sigue estos pasos:
Para restablecer una copia de seguridad habilitada para CMEK en una configuración de instancia multirregional, haz lo siguiente:
Visualiza los registros de auditoría de la clave de Cloud KMS
Asegúrate de que el registro esté habilitado para la API de Cloud KMS en tu proyecto.
En la consola de Google Cloud , accede al Explorador de registros.
Limita las entradas de registro a tu clave de Cloud KMS agregando las siguientes líneas al compilador de consultas:
resource.type="cloudkms_cryptokey" resource.labels.location="KMS_KEY_LOCATION" resource.labels.key_ring_id="KMS_KEY_RING_ID" resource.labels.crypto_key_id="KMS_KEY_ID"En las operaciones normales, las acciones de encriptación y desencriptación se registran con gravedad
INFO. Estas entradas se registran a medida que las zonas de tu instancia de Spanner sondean la clave de Cloud KMS aproximadamente cada cinco minutos.Si Spanner no puede acceder a la clave, las operaciones se registran como
ERROR.