Migrar suas cargas de trabalho do Redis e do Valkey para o Memorystore for Valkey

Neste documento, explicamos como automatizar a migração das suas cargas de trabalho autogerenciadas do Redis e do Valkey para o Memorystore for Valkey. A migração para um ambiente totalmente gerenciado elimina o fardo operacional de gerenciar sua própria infraestrutura, para que você não precise lidar com a aplicação manual de patches no SO, a configuração de replicação ou scripts de backup personalizados. Esse recurso permite que você aproveite o failover automático integrado, a conectividade segura de VPC e o escalonamento sem inatividade.

Ao migrar suas cargas de trabalho autogerenciadas para o Memorystore for Valkey, você tem as seguintes vantagens que eliminam o trabalho operacional e modernizam sua infraestrutura de banco de dados:

• Elimine a sobrecarga operacional: transfira tarefas manuais e demoradas para o Google Cloud, como aplicação de patches no SO, monitoramento de infraestrutura, scripts de backup e gerenciamento de replicação. Como resultado, você pode se concentrar no desenvolvimento de aplicativos em vez da manutenção do banco de dados.
• Alcance alta disponibilidade de nível empresarial: aproveite um SLA de 99,99% totalmente gerenciado. O Memorystore for Valkey oferece failover automático e recursos integrados de backup e restauração. Isso protege os aplicativos contra falhas inesperadas de nós e garante uma rápida recuperação de desastres.
• Escalonamento com tempo de inatividade quase zero: escalone as instâncias de maneira dinâmica para dentro ou para fora para lidar com picos de tráfego imprevisíveis. É possível expandir para centenas de nós (até 250 fragmentos) sem colocar os aplicativos off-line.
• Melhore sua segurança: substitua regras de rede complexas e configuradas manualmente por uma conectividade de VPC segura e integrada e controles de acesso granulares baseados no Identity and Access Management (IAM). Isso garante que os limites de segurança rígidos doGoogle Cloudprotejam seus dados.
• Consolide e faça upgrade das suas instâncias: mescle suas instâncias dispersas, isoladas e autogerenciadas em uma única implantação de alto desempenho no Memorystore for Valkey. Como parte dessa migração, também é possível fazer upgrade automático das versões desatualizadas do Redis ou do Valkey para as versões mais recentes compatíveis.
• Aproveite análises avançadas em tempo real e IA generativa: faça a transição para um ambiente otimizado que oferece latências de microssegundos para armazenamento em cache e gerenciamento de sessões. Para potencializar seus aplicativos de IA generativa (GenAI), você tem acesso imediato e gerenciado a recursos avançados, como a busca vetorial.

Compatibilidade das versões

A tabela nesta seção lista as seguintes informações sobre as instâncias autogerenciadas de origem do Redis e do Valkey e as instâncias de destino no Memorystore for Valkey:

• Os tipos e as versões das instâncias de origem compatíveis com a migração
• As versões das instâncias de destino do Memorystore for Valkey para as quais você pode migrar suas cargas de trabalho.

Tipo de instância de origem	Versão da instância de origem	Versão da instância de destino
Redis	3.2.x - 7.2.x	Valkey 7.2, 8.0, 9.0 e 9.1
Valkey	7.x, 8.x e 9.x	Valkey 7.2, 8.0, 9.0 e 9.1

Importante: a versão da instância de destino precisa ser igual ou mais recente que a da instância de origem. Não é possível fazer downgrade da instância de destino para uma versão anterior.

Antes de começar

Antes de começar a migrar as cargas de trabalho, conclua os pré-requisitos desta seção.

Use o Google Cloud console, a CLI gcloud e as APIs

Para usar o console do Google Cloud , a Google Cloud CLI (CLI gcloud) e as APIs, faça o seguinte:

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. Instale e inicialize a Google Cloud CLI.

   Se você já instalou a CLI gcloud, execute gcloud components update para verificar se você tem a versão mais recente. Para acessar os comandos da CLI gcloud do Memorystore para Valkey, você precisa de pelo menos a versão 489.0.0 da CLI gcloud.

4. Ative a API Memorystore for Valkey.
   API Memorystore for Valkey
5. Ative a API Network Connectivity.
   API Network Connectivity
6. Ative a API Service Consumer Management.
   API Service Consumer Management
7. Ative a API Compute Engine.
   API Compute Engine

Atribuir papéis e permissões

Para migrar suas cargas de trabalho autogerenciadas do Redis e do Valkey para o Memorystore for Valkey, peça ao administrador para conceder a você o papel do IAM de administrador do Memorystore (roles/memorystore.admin) no projeto do Google Cloud . Para mais informações sobre esse papel, consulte Papéis predefinidos.

Para criar e visualizar anexos de rede, peça ao administrador para conceder a você o papel do IAM de Administrador da rede do Compute (roles/compute.networkAdmin) no seu projeto do Google Cloud . Para mais informações sobre esse papel, consulte Papéis do Compute Engine.

Fluxo de trabalho para migrar suas cargas de trabalho

Para migrar suas cargas de trabalho autogerenciadas do Redis e do Valkey para o Memorystore for Valkey, faça o seguinte:

1. Prepare a instância de origem: configure a instância autogerenciada do Redis ou do Valkey para permitir conexões seguras e replicação de saída para o Memorystore for Valkey.
2. Prepare a instância de destino: determine as especificações necessárias da instância, como a contagem de fragmentos e o tipo de nó.
3. Criar a instância de destino: provisione a instância do Memorystore for Valkey que recebe os dados migrados.
4. Configurar um anexo de rede: configure um anexo de rede. Esse anexo permite que a instância de destino (que reside em uma rede VPC gerenciada pelo Google) inicie conexões com a instância de origem (que reside na sua rede VPC). Como resultado, a replicação é estabelecida.
5. Iniciar a migração: inicie o processo de sincronização. A instância de destino se conecta automaticamente à instância de origem e replica continuamente seus dados como uma réplica de leitura.
6. Monitore a migração: verifique se a migração está progredindo sem problemas e se o status dela é HEALTHY.
7. Conclua a migração: transfira o tráfego do aplicativo para a instância de destino.

Preparar a instância de origem

Prepare sua instância autogerenciada do Redis ou do Valkey para migrar suas cargas de trabalho para uma instância de destino do Memorystore for Valkey.

Para permitir conexões dos nós da instância de destino com os nós da instância de origem, faça o seguinte:

• Se você ativou o modo protegido nos nós de origem, desative-o.
• Se você configurou os nós de origem usando uma diretiva bind explícita, atualize os nós para permitir conexões de entrada dos nós de destino. Os nós de destino iniciam conexões dos endereços IP na sub-rede do anexo de rede.
• Atualize as regras de firewall que possam bloquear conexões de entrada dos nós de destino.
• Se você tiver ativado a autenticação e o Transport Layer Security (TLS) nos nós de origem, desative-os.

Para permitir que os nós de destino estabeleçam replicação com os nós de origem, faça o seguinte:

• Não renomeie comandos do Valkey ou do Redis que realizam modificações de dados ou são usados para replicação (por exemplo, PING, PSYNC e HSET).
• Se você usa listas de controle de acesso (ACL) na instância, permita os seguintes comandos para o usuário default para que a instância de destino possa estabelecer a replicação:
  • REPLCONF
  • SYNC
  • PSYNC
  • PING
  • INFO
  • CLUSTER | NODES
• Verifique se a instância de origem tem memória e capacidade de CPU suficientes para gerenciar a carga de replicação extra dos nós de destino.

Importante: anote o endereço IP e o número da porta da instância de origem. Você precisa dessas informações para iniciar o processo de migração.

Além disso, o Memorystore for Valkey precisa se comunicar com esse endereço IP e porta durante todo o processo de migração. O Memorystore para Valkey usa o endereço IP e a porta para descobrir automaticamente os outros nós na topologia da instância.

Preparar a instância de destino

Para garantir um processo de replicação tranquilo, dimensione a instância de destino do Memorystore para Valkey de forma adequada para lidar com a carga de trabalho recebida da instância de origem. Para fazer isso, determine as especificações exatas da instância de destino. Essas especificações incluem a compatibilidade com a instância de origem, o modo de cluster, o número de bancos de dados, a contagem de fragmentos, a versão da instância e o tipo de nó.

Para preparar a instância de destino, siga estas diretrizes:

• Compatibilidade com a instância de origem: as instâncias de origem e de destino precisam estar no mesmo projeto e região do Google Cloud .
• Modo de cluster: o modo de cluster da instância de destino precisa corresponder ao modo de cluster da instância de origem. Se a instância de origem estiver com o modo de cluster desativado, a instância de destino também precisará estar com o modo de cluster desativado. Caso contrário, o modo de cluster precisa estar ativado na instância de destino.
• Número de bancos de dados: se a instância de destino estiver com o modo de cluster desativado, o número de bancos de dados lógicos na instância precisará ser igual ou maior que o número de bancos de dados na instância de origem.
• Contagem de fragmentos: se a instância de destino estiver com o modo de cluster ativado, o número de fragmentos na instância precisará corresponder ao número de fragmentos na instância de origem. No entanto, o número de réplicas nas instâncias de origem e de destino pode ser diferente.
• Versão da instância: a versão da instância de destino precisa ser compatível com a versão da instância de origem. Para mais informações, consulte Suporte de versão.
• Versão de manutenção: a versão de manutenção da instância de destino precisa ser MEMORYSTORE_20260313_01_00 ou posterior. Para mais informações, consulte Sobre a manutenção.
• Tipo de nó: o tipo de nó da instância de destino precisa ser grande o suficiente para processar os dados que recebe dos nós de origem. Para mais informações sobre os tipos de nó que podem ser selecionados para a instância de destino e a capacidade de keyspace correspondente para cada tipo de nó, consulte Especificação do tipo de nó.

Importante: não é possível usar instâncias de replicação entre regiões como instâncias de destino. Além disso, verifique se o Memorystore for Valkey não bloqueia nenhum dos comandos usados na instância de origem.

Criar a instância de destino

Se você não tiver uma instância de destino que atenda aos requisitos para receber os dados que o Memorystore for Valkey migra da instância de origem, crie a instância.

Para criar essa instância, use o Google Cloud console, a CLI gcloud ou a API REST. Para mais informações sobre como criar a instância, consulte Criar instâncias.

Importante: antes de criar a instância de destino, leia as diretrizes para dimensioná-la e configurá-la adequadamente. Para mais informações, consulte Preparar a instância de destino.

Configurar um anexo de rede

Para migrar as cargas de trabalho de uma instância de origem para uma instância de destino, os nós de destino precisam se conectar aos nós de origem. Para ativar essa conexão, use um anexo de rede. Os nós de destino iniciam conexões da sub-rede na rede VPC da instância de origem que está vinculada ao anexo de rede.

É possível usar um anexo de rede que atenda aos seguintes requisitos:

• Ele precisa estar no mesmo projeto e região do Google Cloud da instância de destino.
• A sub-rede precisa estar localizada na mesma rede VPC que a instância de origem.
• A sub-rede da instância de origem precisa ter um intervalo CIDR de IP adequado que ofereça suporte a um mínimo de N+1 endereços IP utilizáveis (em que N é o número de nós na instância de destino). Por exemplo, se uma instância de destino tiver três fragmentos e uma réplica, ela terá seis nós: três nós para a instância principal e três nós para a réplica. Portanto, você precisa de pelo menos sete endereços IP.
• O intervalo de sub-rede não pode se sobrepor a 10.0.0.0/23 porque o Memorystore for Valkey reserva esse intervalo.

Se o anexo de rede não atender a esses requisitos ou se você não tiver um, será necessário criar um. Para saber mais, consulte Criar anexos de rede.

Iniciar a migração

Ao iniciar a migração, a instância de destino estabelece a replicação com a instância de origem. A instância de destino replica automaticamente todos os dados que o aplicativo grava na instância de origem. A instância de destino se torna uma réplica de leitura da instância de origem.

Para iniciar a migração, use o Google Cloud console, a CLI gcloud ou a API REST.

Importante: antes de iniciar a migração, consulte as diretrizes em Configurar um anexo de rede. Além disso, depois de iniciar a migração, não realize operações de migração de slots na instância de origem (como reequilibrar a instância ou mover manualmente slots de hash entre fragmentos) até que você conclua a migração.

Console

1. No console do Google Cloud , acesse a página do Memorystore for Valkey.

   Memorystore for Valkey

2. Clique no ID da instância de destino.

3. Na página Visão geral da instância, clique em Iniciar migração.

4. Na janela Migrar instâncias autogerenciadas do Redis e do Valkey, faça o seguinte:

5. Na guia Preparar, leia as informações sobre os pré-requisitos da instância de origem e as diretrizes para o anexo de rede. Em seguida, clique em Continuar.

6. Na guia Conectar, faça o seguinte:

   1. Insira o Endereço IP e a Porta da instância de origem. Você anotou essas informações em Preparar a instância de origem.
   2. Selecione o anexo de rede que você quer usar para migrar dados.
   3. Clique em Continuar.

7. Na guia Revisar, confira as informações associadas ao processo de migração. Essas informações incluem o ID da instância de destino, o endereço IP e a porta da instância de origem e o nome do anexo de rede. Depois de analisar essas informações, clique em Iniciar migração.

8. Na página Visão geral da instância, verifique se o status Migrando aparece.

Se os nós de destino não puderem se conectar aos nós de origem ou se a instância de origem não puder replicar dados para a instância de destino, a migração vai falhar.

Quando isso ocorre, o Memorystore para Valkey reverte a instância de destino para o estado em que estava antes de você iniciar o processo de migração. O status da instância de destino volta para Pronto, e a instância volta a ter recursos de leitura e gravação.

Depois de resolver os problemas que causaram a falha na migração, você poderá iniciá-la novamente.

gcloud

Use o comando gcloud memorystore instances start-migration da seguinte maneira:

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

Faça as seguintes substituições:

• INSTANCE_ID: o ID da instância de destino.
• PROJECT_ID: o ID ou número do projeto do Google Cloud projeto que contém essa instância.
• REGION_ID: o ID da região em que a instância está localizada.
• SOURCE_IP_ADDRESS: o endereço IP da instância de origem. Você anotou esse endereço IP em Preparar a instância de origem.
• SOURCE_PORT: o número da porta da instância de origem. Você anotou essa porta em Preparar a instância de origem.
• NETWORK_ATTACHMENT_ID: o ID do anexo de rede.

Para confirmar se a migração foi iniciada, use o comando gcloud memorystore instances describe, da seguinte maneira:

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

Verifique se um status MIGRATING aparece ao lado do parâmetro state.

Se os nós de destino não puderem se conectar aos nós de origem ou se a instância de origem não puder replicar dados para a instância de destino, a migração vai falhar.

Quando isso ocorre, o Memorystore para Valkey reverte a instância de destino para o estado em que estava antes de você iniciar o processo de migração. O status da instância de destino volta para ACTIVE, e a instância volta a ter recursos de leitura e gravação.

Depois de resolver os problemas que causaram a falha na migração, você poderá iniciá-la novamente.

REST

Para iniciar a migração, use o seguinte comando da API REST.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• PROJECT_ID: o ID ou número do projeto do Google Cloud que contém a instância de destino.
• REGION_ID: o ID da região em que a instância está localizada.
• INSTANCE_ID: o ID da instância.
• SOURCE_IP_ADDRESS: o endereço IP da instância de origem. Você anotou esse endereço IP em Preparar a instância de origem.
• SOURCE_PORT: o número da porta da instância de origem. Você anotou essa porta em Preparar a instância de origem.
• NETWORK_ATTACHMENT_ID: o ID do anexo de rede.

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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
}

Monitorar a migração

Para garantir que a migração ocorra sem problemas, monitore as instâncias de origem e de destino.

Monitorar a instância de origem

Na instância de origem, verifique se o uso do buffer de saída do cliente permanece baixo nos nós de origem. Para verificar o uso do buffer, siga um destes procedimentos:

• Usar os painéis de monitoramento atuais
• Conecte-se à instância de origem com o cliente Redis ou Valkey e execute o comando INFO CLIENTS para verificar as métricas do buffer de saída.

O uso baixo sustentado indica um atraso mínimo e uma sincronização bem-sucedida dos dados da instância de origem para a instância de destino.

Monitorar a instância de destino

É possível monitorar a integridade da migração da instância de origem para o Memorystore for Valkey. Para fazer isso, verifique a métrica Status da migração (/instance/migration_status) da instância de destino para confirmar se o status atual dela é HEALTHY. Esse status indica que os links de replicação entre os fragmentos das instâncias de origem e destino estão ativos e funcionando corretamente durante o processo de migração.

Para verificar a métrica Status da migração da instância usando o console doGoogle Cloud , faça o seguinte:

1. No console do Google Cloud , acesse a página do Metrics Explorer.

   Metrics Explorer

2. No menu Métrica, selecione a métrica Status da migração. Para fazer isso, selecione Instância do Memorystore  > Instância  > Status da migração e clique em Aplicar.

3. No campo Filtro, adicione o seguinte filtro: instance_id = (equals) INSTANCE_ID.

   Substitua INSTANCE_ID pelo ID da instância de destino.

4. Na seção Resultados, verifique o status atual da instância. Se um status HEALTHY aparecer, a instância está funcionando e você pode concluir a migração.

   Se o status HEALTHY não aparecer, use a métrica Status da migração para os nós principais da instância de destino. Ao monitorar esses nós, é possível determinar se algum nó específico não está íntegro.

   Para usar a métrica Status da migração para os nós da instância, faça o seguinte:

   1. No menu Métrica, selecione a métrica Status da migração. Para fazer isso, selecione Nó da instância do Memorystore  > Instância  > Status da migração e clique em Aplicar.

   2. No campo Filtro, adicione o seguinte filtro: role = (equals) primary.

   3. Na seção Resultados, verifique se o status atual de todos os nós primários é Íntegro. Se o status for HEALTHY, os nós estão funcionando e você pode concluir a migração.

Concluir a migração

Para concluir a migração, use o console do Google Cloud , a CLI gcloud ou a API REST.

Importante: por padrão, o Memorystore for Valkey garante que a instância de destino esteja totalmente atualizada com a instância de origem até o momento em que você conclui a migração. As gravações na instância de origem depois que você concluir a migração podem não ser replicadas.

Se você quiser consistência total de dados entre as instâncias de origem e de destino, sem perda de dados, interrompa todas as operações de gravação na instância de origem antes de concluir a migração.

Console

1. No console do Google Cloud , acesse a página do Memorystore for Valkey.

   Memorystore for Valkey

2. Clique no ID da instância de destino.

3. Na página Visão geral da instância, clique em Concluir migração.

4. Na caixa de diálogo Concluir migração, faça o seguinte:

   1. Se você quiser garantir que a instância de destino replique todos os dados da instância de origem, selecione Padrão.

      Atenção: se você quiser transferir o tráfego do aplicativo para a instância de destino imediatamente, selecione Forçar (pular sincronização). No entanto, se você fizer essa seleção, o Memorystore for Valkey talvez não consiga replicar todos os dados da instância de origem para a instância de destino.

   2. No campo de texto ID da instância, insira o ID da instância de destino.

   3. Clique em Concluir migração.

5. Na página Visão geral da instância, verifique se o status Migrado aparece.

Importante: depois de concluir a migração, atualize os arquivos de configuração do aplicativo para direcionar todo o tráfego para a instância de destino.

gcloud

Use o comando gcloud memorystore instances finish-migration da seguinte maneira:

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

Faça as seguintes substituições:

• INSTANCE_ID: o ID da instância de destino
• PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém essa instância
• REGION_ID: o ID da região em que a instância está localizada.

Atenção: se você quiser transferir o tráfego do aplicativo para a instância de destino imediatamente, use o parâmetro --force. No entanto, ao usar esse parâmetro, o Memorystore for Valkey talvez não consiga replicar todos os dados da instância de origem para a instância de destino.

Para confirmar que a migração foi concluída, use o comando gcloud memorystore instances describe, da seguinte maneira:

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

Verifique se um status MIGRATED aparece ao lado do parâmetro state.

Importante: depois de concluir a migração, atualize os arquivos de configuração do aplicativo para direcionar todo o tráfego para a instância de destino.

REST

Para concluir a migração, use o seguinte comando da API REST.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• PROJECT_ID: o ID do projeto do Google Cloud que contém a instância de destino.
• REGION_ID: o ID da região em que a instância está localizada.
• INSTANCE_ID: o ID da instância.

• FORCE_BOOLEAN: opcional. Esse parâmetro determina se o Memorystore for Valkey força a conclusão imediata da migração.

  • Se você definir esse parâmetro como true, o Memorystore for Valkey vai concluir a migração imediatamente para que você possa transferir o tráfego do aplicativo para a instância de destino. No entanto, o Memorystore for Valkey talvez não consiga replicar todos os dados da instância de origem para a de destino.
  • Se você definir esse parâmetro como false, o Memorystore for Valkey vai replicar todos os dados da instância de origem para a instância de destino até o momento em que você concluir a migração.

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "force": FORCE_BOOLEAN
}

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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
}