Migra tus cargas de trabajo de Redis y Valkey a Memorystore for Valkey

En este documento, se explica cómo automatizar la migración de tus cargas de trabajo autoadministradas de Redis y Valkey a Memorystore para Valkey. La migración a un entorno completamente administrado elimina la carga operativa de administrar tu propia infraestructura, por lo que no tienes que encargarte de la aplicación manual de parches del SO, la configuración de la replicación ni las secuencias de comandos de copia de seguridad personalizadas. Esta función te permite aprovechar la conmutación por error automática integrada, la conectividad segura de VPC y el escalamiento sin tiempo de inactividad.

Si migras tus cargas de trabajo autoadministradas a Memorystore para Valkey, desbloquearás las siguientes ventajas que eliminan el trabajo operativo y modernizan tu infraestructura de base de datos:

• Elimina la sobrecarga operativa: descarga las tareas manuales y que requieren mucho tiempo en Google Cloud, como la aplicación de parches del SO, la supervisión de la infraestructura, las secuencias de comandos de copia de seguridad y la administración de la replicación. Como resultado, puedes enfocarte en el desarrollo de aplicaciones en lugar del mantenimiento de la base de datos.
• Logra una alta disponibilidad de nivel empresarial: Benefíciate de un ANS del 99.99% completamente administrado. Memorystore for Valkey proporciona conmutación por error automática y funciones integradas de copia de seguridad y restablecimiento. Esto protege tus aplicaciones de fallas inesperadas en los nodos y garantiza una rápida recuperación ante desastres.
• Escala con un tiempo de inactividad casi nulo: Escala tus instancias de forma dinámica para adaptarlas a los aumentos repentinos de tráfico impredecibles. Puedes expandirte a cientos de nodos (hasta 250 fragmentos) sin desconectar tus aplicaciones.
• Mejora la seguridad: Reemplaza las reglas de red complejas y configuradas de forma manual por una conectividad de VPC segura y, además, controles de acceso detallados basados en Identity and Access Management (IAM). Esto garantiza que los límites de seguridad estrictos deGoogle Cloudprotejan tus datos.
• Consolida y actualiza tus instancias: Combina tus instancias dispersas, aisladas y autoadministradas en una sola implementación de alto rendimiento en Memorystore for Valkey. Como parte de esta migración, también puedes actualizar automáticamente tus versiones obsoletas de Redis o Valkey a las versiones compatibles más recientes.
• Desbloquea las estadísticas avanzadas en tiempo real y la IA generativa: Realiza la transición a un entorno optimizado que ofrezca latencias de microsegundos para el almacenamiento en caché y la administración de sesiones. Para potenciar tus aplicaciones de IA generativa (GenAI), obtienes acceso inmediato y administrado a funciones avanzadas, como Vector Search.

Compatibilidad con las versiones

En la tabla de esta sección, se muestra la siguiente información sobre las instancias autoadministradas de Redis y Valkey de origen, y las instancias de destino en Memorystore para Valkey:

• Los tipos y las versiones de las instancias de origen que admite la migración
• Las versiones de las instancias de Memorystore para Valkey de destino a las que puedes migrar tus cargas de trabajo

Tipo de instancia de origen	Versión de la instancia de origen	Versión de la instancia de destino
Redis	3.2.x - 7.2.x	Valkey 7.2, 8.0, 9.0 y 9.1
Valkey	7.x, 8.x y 9.x	Valkey 7.2, 8.0, 9.0 y 9.1

Importante: La versión de la instancia de destino debe ser la misma o una versión posterior que la instancia de origen. No puedes cambiar la instancia de destino a una versión anterior.

Antes de comenzar

Antes de comenzar a migrar tus cargas de trabajo, completa los requisitos previos de esta sección.

Usa la consola de Google Cloud , gcloud CLI y las APIs

Para usar la consola de Google Cloud , Google Cloud CLI (gcloud CLI) y las APIs, haz lo siguiente:

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. Instala y, luego, inicializa Google Cloud CLI.

   Si ya instalaste gcloud CLI, asegúrate de tener la versión más reciente. Para esto, ejecuta gcloud components update. Para acceder a los comandos de gcloud CLI de Memorystore para Valkey, necesitas, al menos, la versión 489.0.0 de gcloud CLI.

4. Habilita la API de Memorystore para Valkey.
   API de Memorystore para Valkey
5. Habilita la API de Network Connectivity.
   API de Network Connectivity
6. Habilita la API de Service Consumer Management.
   API de Service Consumer Management
7. Habilita la API de Compute Engine.
   API de Compute Engine

Asigna roles y permisos

Para migrar tus cargas de trabajo de Redis y Valkey autoadministradas a Memorystore para Valkey, pídele a tu administrador que te otorgue el rol de IAM de administrador de Memorystore (roles/memorystore.admin) en tu proyecto de Google Cloud . Para obtener más información sobre este rol, consulta Roles predefinidos.

Para crear y ver adjuntos de red, pídele a tu administrador que te otorgue el rol de IAM de administrador de red de Compute (roles/compute.networkAdmin) en tu proyecto de Google Cloud . Para obtener más información sobre este rol, consulta Roles de Compute Engine.

Flujo de trabajo para migrar tus cargas de trabajo

Para migrar tus cargas de trabajo autoadministradas de Redis y Valkey a Memorystore para Valkey, realiza las siguientes acciones:

1. Prepara tu instancia de origen: Configura tu instancia de Redis o Valkey autoadministrada para permitir conexiones seguras y replicación saliente a Memorystore para Valkey.
2. Prepara la instancia de destino: Determina las especificaciones de la instancia que necesitas, como el recuento de fragmentos y el tipo de nodo.
3. Crea la instancia de destino: aprovisiona la instancia de Memorystore para Valkey que recibe tus datos migrados.
4. Configura un adjunto de red: Configura un adjunto de red. Este adjunto permite que la instancia de destino (que reside en una red de VPC administrada por Google) inicie conexiones a la instancia de origen (que reside en tu red de VPC). Como resultado, se establece la replicación.
5. Inicia la migración: Inicia el proceso de sincronización. La instancia de destino se conecta automáticamente a tu instancia de origen y replica tus datos de forma continua como una réplica de lectura.
6. Supervisa la migración: Verifica que la migración progrese sin problemas y que el estado de la migración sea HEALTHY.
7. Finaliza la migración: Transfiere el tráfico de tu aplicación a la instancia de destino.

Prepara la instancia de origen

Debes preparar tu instancia autoadministrada de Redis o Valkey para poder migrar tus cargas de trabajo a una instancia de destino de Memorystore para Valkey.

Para permitir conexiones desde los nodos de la instancia de destino a los nodos de la instancia de origen, haz lo siguiente:

• Si habilitaste el modo protegido en los nodos de origen, desactívalo.
• Si configuraste los nodos de origen con una directiva bind explícita, actualiza los nodos para permitir las conexiones entrantes desde los nodos de destino. Los nodos de destino inician conexiones desde las direcciones IP de la subred del adjunto de red.
• Actualiza las reglas de firewall que puedan bloquear las conexiones entrantes desde los nodos de destino.
• Si habilitaste la autenticación y la seguridad de la capa de transporte (TLS) en los nodos de origen, desactívalas.

Para permitir que los nodos de destino establezcan la replicación con los nodos de origen, haz lo siguiente:

• No cambies el nombre de ningún comando de Valkey o Redis que realice modificaciones de datos o se use para la replicación (por ejemplo, PING, PSYNC y HSET).
• Si usas listas de control de acceso (ACL) para tu instancia, permite los siguientes comandos para el usuario default, de modo que la instancia de destino pueda establecer la replicación:
  • REPLCONF
  • SYNC
  • PSYNC
  • PING
  • INFO
  • CLUSTER | NODES
• Asegúrate de que la instancia de origen tenga suficiente capacidad de memoria y CPU para administrar la carga de replicación adicional de los nodos de destino.

Importante: Toma nota de la dirección IP y el número de puerto de la instancia de origen. Necesitas esta información para iniciar el proceso de migración.

Además, Memorystore para Valkey debe poder comunicarse con esta dirección IP y este puerto durante todo el proceso de migración. Memorystore for Valkey usa la dirección IP y el puerto para descubrir automáticamente los otros nodos en la topología de la instancia.

Prepara la instancia de destino

Para garantizar un proceso de replicación sin problemas, debes ajustar el tamaño de tu instancia de Memorystore para Valkey de destino de forma adecuada para controlar la carga de trabajo entrante desde tu instancia de origen. Para ello, determina las especificaciones exactas de tu instancia de destino. Estas especificaciones incluyen la compatibilidad con la instancia de origen, el modo de clúster, la cantidad de bases de datos, el recuento de fragmentos, la versión de la instancia y el tipo de nodo.

Para preparar la instancia de destino, sigue estos lineamientos:

• Compatibilidad con la instancia de origen: Las instancias de origen y de destino deben residir en el mismo proyecto y la misma región de Google Cloud .
• Modo de clúster: El modo de clúster de la instancia de destino debe coincidir con el modo de clúster de la instancia de origen. Si la instancia de origen tiene el modo de clúster inhabilitado, la instancia de destino también debe tenerlo inhabilitado. De lo contrario, la instancia de destino debe tener habilitado el modo de clúster.
• Cantidad de bases de datos: Si la instancia de destino tiene inhabilitado el modo de clúster, la cantidad de bases de datos lógicas en la instancia debe ser igual o mayor que la cantidad de bases de datos en la instancia de origen.
• Recuento de fragmentos: Si la instancia de destino tiene habilitado el modo de clúster, la cantidad de fragmentos en la instancia debe coincidir con la cantidad de fragmentos en la instancia de origen. Sin embargo, la cantidad de réplicas en las instancias de origen y de destino puede ser diferente.
• Versión de la instancia: La versión de la instancia de destino debe ser compatible con la versión de la instancia de origen. Para obtener más información, consulta Asistencia de versiones.
• Versión de mantenimiento: La versión de mantenimiento de la instancia de destino debe ser MEMORYSTORE_20260313_01_00 o posterior. Para obtener más información, consulta Acerca del mantenimiento.
• Tipo de nodo: El tipo de nodo de la instancia de destino debe ser lo suficientemente grande como para controlar los datos que recibe de los nodos de origen. Para obtener más información sobre los tipos de nodos que puedes seleccionar para la instancia de destino y la capacidad de keyspace correspondiente para cada tipo de nodo, consulta Especificación del tipo de nodo.

Importante: No puedes usar instancias de replicación entre regiones como instancias de destino. Además, verifica que Memorystore para Valkey no bloquee ninguno de los comandos que usas en la instancia de origen.

Crea la instancia de destino

Si no tienes una instancia de destino que cumpla con los requisitos para recibir los datos que Memorystore para Valkey migra desde la instancia de origen, debes crear la instancia.

Para crear esta instancia, usa la consola de Google Cloud , la gcloud CLI o la API de REST. Para obtener más información sobre cómo crear la instancia, consulta Crea instancias.

Importante: Antes de crear la instancia de destino, revisa los lineamientos para dimensionarla y configurarla de forma adecuada. Para obtener más información, consulta Prepara la instancia de destino.

Configura un adjunto de red

Para migrar las cargas de trabajo de una instancia de origen a una instancia de destino, los nodos de destino deben conectarse a los nodos de origen. Para habilitar esta conexión, debes usar un adjunto de red. Los nodos de destino inician conexiones desde la subred en la red de VPC de la instancia de origen que está vinculada al adjunto de red.

Puedes usar un adjunto de red que cumpla con los siguientes requisitos:

• Debe residir en el mismo proyecto y la misma región de Google Cloud que la instancia de destino.
• Su subred debe estar ubicada dentro de la misma red de VPC que la instancia de origen.
• La subred de la instancia de origen debe tener un rango CIDR de IP adecuado que admita un mínimo de N+1 direcciones IP utilizables (en las que N es la cantidad de nodos en la instancia de destino). Por ejemplo, si una instancia de destino tiene tres fragmentos y una réplica, tiene seis nodos: tres nodos para la instancia principal y tres nodos para la réplica. Por lo tanto, necesitas al menos siete direcciones IP.
• El rango de subred no puede superponerse con 10.0.0.0/23 porque Memorystore para Valkey reserva este rango.

Si tu adjunto de red no cumple con estos requisitos o no tienes uno, debes crearlo. Para obtener más información, consulta Crea adjuntos de red.

Inicia la migración

Cuando se inicia la migración, la instancia de destino establece la replicación con la instancia de origen. La instancia de destino replica automáticamente los datos que tu aplicación escribe en la instancia de origen. La instancia de destino se convierte en una réplica de lectura de la instancia de origen.

Para iniciar la migración, usa la consola de Google Cloud , la gcloud CLI o la API de REST.

Importante: Antes de comenzar la migración, revisa los lineamientos que se indican en Configura un adjunto de red. Además, después de iniciar la migración, no realices operaciones de migración de ranuras en la instancia de origen (como volver a equilibrar la instancia o mover manualmente las ranuras de hash entre fragmentos) hasta que termines la migración.

Console

1. En la consola de Google Cloud , ve a la página Memorystore para Valkey.

   Memorystore for Valkey

2. Haz clic en el ID de la instancia de destino.

3. En la página Resumen de la instancia, haz clic en Iniciar migración.

4. En la ventana Migrar instancias autoadministradas de Redis y Valkey, haz lo siguiente:

5. En la pestaña Preparar, lee la información sobre los requisitos previos de la instancia de origen y los lineamientos para el adjunto de red. Luego, haz clic en Continuar.

6. En la pestaña Conectar, haz lo siguiente:

   1. Ingresa la dirección IP y el puerto de la instancia de origen. Anotaste esta información en Prepara tu instancia de origen.
   2. Selecciona el adjunto de red que quieres usar para migrar datos.
   3. Haz clic en Continuar.

7. En la pestaña Revisar, revisa la información asociada con el proceso de migración. Esta información incluye el ID de la instancia de destino, la dirección IP y el puerto de la instancia de origen, y el nombre del adjunto de red. Después de revisar esta información, haz clic en Iniciar la migración.

8. En la página Resumen de la instancia, verifica que aparezca el estado Migrando.

Si los nodos de destino no pueden conectarse a los nodos de origen o si la instancia de origen no puede replicar datos en la instancia de destino, la migración falla.

Cuando esto ocurre, Memorystore para Valkey revierte la instancia de destino a su estado anterior al inicio del proceso de migración. El estado de la instancia de destino vuelve a ser Listo, y la instancia vuelve a tener capacidades de lectura y escritura.

Después de resolver los problemas que causaron el error en la migración, puedes volver a iniciarla.

gcloud

Usa el comando gcloud memorystore instances start-migration de la siguiente manera:

gcloud memorystore instances start-migration INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--source-ip=SOURCE_IP_ADDRESS \
--source-port=SOURCE_PORT \
--network-attachment=projects/PROJECT_ID/locations/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID

Realiza los siguientes reemplazos:

• INSTANCE_ID: el ID de la instancia de destino.
• PROJECT_ID: Es el ID o el número del proyecto de Google Cloud que contiene esta instancia.
• REGION_ID: Es el ID de la región en la que se encuentra la instancia.
• SOURCE_IP_ADDRESS: Es la dirección IP de la instancia de origen. Anotaste esta dirección IP en Prepara tu instancia de origen.
• SOURCE_PORT: Es el número de puerto de la instancia de origen. Anotaste este puerto en Prepara tu instancia de origen.
• NETWORK_ATTACHMENT_ID: Es el ID del adjunto de red.

Para confirmar que la migración se inició correctamente, usa el comando gcloud memorystore instances describe de la siguiente manera:

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Verifica que aparezca un estado MIGRATING junto al parámetro state.

Si los nodos de destino no pueden conectarse a los nodos de origen o si la instancia de origen no puede replicar datos en la instancia de destino, la migración falla.

Cuando esto ocurre, Memorystore para Valkey revierte la instancia de destino a su estado anterior al inicio del proceso de migración. El estado de la instancia de destino vuelve a ser ACTIVE, y la instancia vuelve a tener capacidades de lectura y escritura.

Después de resolver los problemas que causaron el error en la migración, puedes volver a iniciarla.

REST

Para iniciar la migración, usa el siguiente comando de la API de REST.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID o el número del proyecto de Google Cloud que contiene la instancia de destino.
• REGION_ID: Es el ID de la región en la que se encuentra esta instancia.
• INSTANCE_ID: el ID de la instancia
• SOURCE_IP_ADDRESS: Es la dirección IP de la instancia de origen. Anotaste esta dirección IP en Prepara tu instancia de origen.
• SOURCE_PORT: Es el número de puerto de la instancia de origen. Anotaste este puerto en Prepara tu instancia de origen.
• NETWORK_ATTACHMENT_ID: Es el ID del adjunto de red.

Método HTTP y URL:

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:startMigration

Cuerpo JSON de la solicitud:

{
  "selfManagedSource": {
    "ipAddress": "SOURCE_IP_ADDRESS",
    "port": SOURCE_PORT,
    "networkAttachment": "projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID"
  }
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:startMigration"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:startMigration" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.memorystore.v1.OperationMetadata",
    "createTime": "2026-10-26T20:00:00.000000000Z",
    "target": "projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID",
    "verb": "startMigration",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Supervisa la migración

Para asegurarte de que la migración progrese sin problemas, supervisa las instancias de origen y de destino.

Supervisa la instancia de origen

En la instancia de origen, verifica que el uso del búfer de salida del cliente siga siendo bajo en los nodos de origen. Para verificar el uso del búfer, realiza una de las siguientes acciones:

• Usa tus paneles de supervisión existentes
• Conéctate a la instancia de origen con tu cliente de Redis o Valkey y, luego, ejecuta el comando INFO CLIENTS para verificar las métricas del búfer de salida.

El uso bajo sostenido indica un retraso mínimo y una sincronización correcta de los datos de la instancia de origen a la instancia de destino.

Supervisa la instancia de destino

Puedes supervisar el estado de la migración desde la instancia de origen hasta Memorystore para Valkey. Para ello, verifica la métrica Estado de la migración (/instance/migration_status) de la instancia de destino para comprobar que el estado actual de la instancia sea HEALTHY. Este estado indica que los vínculos de replicación entre los fragmentos de las instancias de origen y de destino están activos y funcionan correctamente durante el proceso de migración.

Para verificar la métrica Estado de la migración de la instancia con la consola deGoogle Cloud , haz lo siguiente:

1. En la consola de Google Cloud , accede a la página Explorador de métricas.

   Explorador de métricas

2. En el menú Métrica, selecciona la métrica Estado de la migración. Para ello, selecciona Instancia de Memorystore  > Instancia  > Estado de la migración y, luego, haz clic en Aplicar.

3. En el campo Filtro, agrega el siguiente filtro: instance_id = (equals) INSTANCE_ID.

   Reemplaza INSTANCE_ID por el ID de la instancia de destino.

4. En la sección Resultados, verifica el estado actual de la instancia. Si aparece el estado HEALTHY, la instancia está funcionando y puedes finalizar la migración.

   Si no aparece el estado HEALTHY, puedes usar la métrica Estado de la migración para los nodos principales de la instancia de destino. Si supervisas estos nodos, puedes determinar si algún nodo específico no está en buen estado.

   Para usar la métrica Estado de la migración en los nodos de la instancia, haz lo siguiente:

   1. En el menú Métrica, selecciona la métrica Estado de la migración. Para hacerlo, selecciona Nodo de instancia de Memorystore  > Instancia  > Estado de la migración y, luego, haz clic en Aplicar.

   2. En el campo Filtro, agrega el siguiente filtro: role = (equals) primary.

   3. En la sección Resultados, verifica que el estado actual de todos los nodos principales sea EN BUEN ESTADO. Si el estado es HEALTHY, los nodos están funcionando y puedes finalizar la migración.

Finaliza la migración

Para finalizar la migración, usa la consola de Google Cloud , gcloud CLI o la API de REST.

Importante: De forma predeterminada, Memorystore for Valkey garantiza que la instancia de destino esté completamente actualizada con la instancia de origen hasta el momento en que finalices la migración. Es posible que no se repliquen las escrituras en la instancia de origen después de que finalices la migración.

Si deseas una coherencia total de los datos entre las instancias de origen y de destino, y que no se pierdan datos, antes de finalizar la migración, detén todas las operaciones de escritura en la instancia de origen.

Console

1. En la consola de Google Cloud , ve a la página Memorystore para Valkey.

   Memorystore for Valkey

2. Haz clic en el ID de la instancia de destino.

3. En la página Resumen de la instancia, haz clic en Finalizar migración.

4. En el cuadro de diálogo Finalizar migración, haz lo siguiente:

   1. Si deseas asegurarte de que la instancia de destino replique todos los datos de la instancia de origen, selecciona Estándar.

      Precaución: Si deseas transferir el tráfico de tu aplicación a la instancia de destino de inmediato, selecciona Forzar (omitir sincronización). Sin embargo, si seleccionas esta opción, es posible que Memorystore para Valkey no pueda replicar todos los datos de la instancia de origen en la instancia de destino.

   2. En el campo de texto ID de instancia, ingresa el ID de la instancia de destino.

   3. Haz clic en Finalizar migración.

5. En la página Resumen de la instancia, verifica que aparezca el estado Migrada.

Importante: Después de finalizar la migración, actualiza los archivos de configuración de tu aplicación para dirigir todo el tráfico a la instancia de destino.

gcloud

Usa el comando gcloud memorystore instances finish-migration de la siguiente manera:

gcloud memorystore instances finish-migration INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Realiza los siguientes reemplazos:

• INSTANCE_ID: Es el ID de la instancia de destino.
• PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene esta instancia
• REGION_ID: Es el ID de la región en la que se encuentra la instancia.

Precaución: Si quieres transferir el tráfico de tu aplicación a la instancia de destino de inmediato, usa el parámetro --force. Sin embargo, con este parámetro, es posible que Memorystore para Valkey no pueda replicar todos los datos de la instancia de origen en la instancia de destino.

Para confirmar que la migración finalice de forma correcta, usa el comando gcloud memorystore instances describe de la siguiente manera:

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Verifica que aparezca un estado MIGRATED junto al parámetro state.

Importante: Después de finalizar la migración, actualiza los archivos de configuración de tu aplicación para dirigir todo el tráfico a la instancia de destino.

REST

Para finalizar la migración, usa el siguiente comando de la API de REST.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto de Google Cloud que contiene la instancia de destino.
• REGION_ID: Es el ID de la región en la que se encuentra esta instancia.
• INSTANCE_ID: el ID de la instancia

• FORCE_BOOLEAN: es opcional. Este parámetro determina si Memorystore para Valkey fuerza la migración para que finalice de inmediato.

  • Si estableces este parámetro en true, Memorystore para Valkey finaliza la migración de inmediato para que puedas transferir el tráfico de tu aplicación a la instancia de destino. Sin embargo, es posible que Memorystore para Valkey no pueda replicar todos los datos de la instancia de origen en la instancia de destino.
  • Si configuras este parámetro como false, Memorystore para Valkey replica todos los datos de la instancia de origen en la instancia de destino hasta el momento en que finalizas la migración.

Método HTTP y URL:

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:finishMigration

Cuerpo JSON de la solicitud:

{
  "force": FORCE_BOOLEAN
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:finishMigration"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:finishMigration" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.memorystore.v1.OperationMetadata",
    "createTime": "2026-10-26T20:00:00.000000000Z",
    "target": "projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID",
    "verb": "finishMigration",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}