Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Migrer vos charges de travail Redis et Valkey vers Memorystore pour Valkey

Ce document explique comment automatiser la migration de vos charges de travail Redis et Valkey autogérées vers Memorystore pour Valkey. La migration vers un environnement entièrement géré élimine la charge opérationnelle liée à la gestion de votre propre infrastructure. Vous n'avez donc pas à gérer manuellement l'application de correctifs à l'OS, la configuration de la réplication ni les scripts de sauvegarde personnalisés. Cette fonctionnalité vous permet de profiter du basculement automatique intégré, d'une connectivité VPC sécurisée et d'un scaling sans temps d'arrêt.

En migrant vos charges de travail autogérées vers Memorystore pour Valkey, vous bénéficiez des avantages suivants, qui éliminent les tâches opérationnelles répétitives et modernisent votre infrastructure de base de données :

Éliminez vos frais généraux opérationnels : déchargez-vous des tâches manuelles et chronophages sur Google Cloud, telles que l'application de correctifs d'OS, la surveillance de l'infrastructure, les scripts de sauvegarde et la gestion de la réplication. Vous pouvez ainsi vous concentrer sur le développement d'applications plutôt que sur la maintenance de la base de données.
Bénéficiez d'une haute disponibilité de niveau entreprise : profitez d'un contrat de niveau de service entièrement géré de 99,99 %. Memorystore pour Valkey fournit un basculement automatique et des fonctionnalités de sauvegarde et de restauration intégrées. Cela protège vos applications contre les défaillances de nœuds inattendues et garantit une reprise après sinistre rapide.
Effectuez un scaling avec un temps d'arrêt quasi nul : effectuez un scaling dynamique de vos instances pour répondre aux pics de trafic imprévisibles. Vous pouvez étendre votre base de données à des centaines de nœuds (jusqu'à 250 segments) sans mettre vos applications hors connexion.
Renforcez votre sécurité : remplacez les règles réseau complexes configurées manuellement par une connectivité VPC intégrée et sécurisée, et des contrôles des accès précis basés sur Identity and Access Management (IAM). Cela permet de garantir que les limites de sécurité strictes deGoogle Cloudprotègent vos données.
Consolidez et mettez à niveau vos instances : fusionnez vos instances dispersées, cloisonnées et autogérées en un seul déploiement hautes performances dans Memorystore pour Valkey. Dans le cadre de cette migration, vous pouvez également mettre à niveau automatiquement vos versions obsolètes de Redis ou Valkey vers les dernières versions compatibles.
Débloquez l'analyse avancée en temps réel et l'IA générative : passez à un environnement optimisé qui offre des latences de l'ordre de la microseconde pour la mise en cache et la gestion des sessions. Pour alimenter vos applications d'IA générative, vous bénéficiez d'un accès géré immédiat à des fonctionnalités avancées telles que Vector Search.

Compatibilité avec les versions

Le tableau de cette section liste les informations suivantes sur les instances Redis et Valkey autogérées sources, ainsi que sur les instances cibles dans Memorystore pour Valkey :

Les types et versions des instances sources compatibles avec la migration
Les versions des instances Memorystore for Valkey cibles vers lesquelles vous pouvez migrer vos charges de travail

Type d'instance source	Version de l'instance source	Version de l'instance cible
Redis	3.2.x - 7.2.x	Valkey 7.2, 8.0, 9.0 et 9.1
Valkey	7.x, 8.x et 9.x	Valkey 7.2, 8.0, 9.0 et 9.1

Avant de commencer

Avant de commencer à migrer vos charges de travail, remplissez les conditions préalables décrites dans cette section.

Utiliser la console Google Cloud , gcloud CLI et les API

Pour utiliser la console Google Cloud , la Google Cloud CLI (gcloud CLI) et les API, procédez comme suit :

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
Verify that billing is enabled for your Google Cloud project.
Installez et initialisez la Google Cloud CLI.

Si vous avez déjà installé la gcloud CLI, assurez-vous de disposer de la dernière version en exécutant gcloud components update. Pour accéder aux commandes gcloud CLI de Memorystore pour Valkey, vous devez disposer au moins de la version 489.0.0 de gcloud CLI.
Activez l'API Memorystore pour Valkey.
API Memorystore pour Valkey
Activez l'API Network Connectivity.
API Network Connectivity
Activez l'API Service Consumer Management.
API Service Consumer Management
Activez l'API Compute Engine.
API Compute Engine

Attribuer des rôles et des autorisations

Pour migrer vos charges de travail Redis et Valkey autogérées vers Memorystore pour Valkey, demandez à votre administrateur de vous accorder le rôle IAM d'administrateur Memorystore (roles/memorystore.admin) sur votre projet Google Cloud . Pour en savoir plus sur ce rôle, consultez Rôles prédéfinis.

Pour créer et afficher des rattachements de réseau, demandez à votre administrateur de vous accorder le rôle IAM d'administrateur de réseaux Compute (roles/compute.networkAdmin) sur votre projet Google Cloud . Pour en savoir plus sur ce rôle, consultez Rôles Compute Engine.

Workflow pour migrer vos charges de travail

Pour migrer vos charges de travail Redis et Valkey autogérées vers Memorystore for Valkey, procédez comme suit :

Préparer votre instance source : configurez votre instance Redis ou Valkey autogérée pour autoriser les connexions sécurisées et la réplication sortante vers Memorystore pour Valkey.
Préparer l'instance cible : déterminez les spécifications d'instance requises, telles que le nombre de segments et le type de nœud.
Créer l'instance cible : provisionnez l'instance Memorystore pour Valkey qui reçoit vos données migrées.
Configurer un rattachement de réseau : configurez un rattachement de réseau. Ce rattachement permet à l'instance cible (qui réside dans un réseau VPC géré par Google) d'établir des connexions avec l'instance source (qui réside dans votre réseau VPC). La réplication est alors établie.
Lancer la migration : lancez le processus de synchronisation. L'instance cible se connecte automatiquement à votre instance source et réplique en continu vos données en tant qu'instance répliquée avec accès en lecture.
Surveillez la migration : vérifiez que la migration se déroule sans problème et que l'état de la migration est OPÉRATIONNEL.
Terminez la migration : basculez le trafic de votre application vers l'instance cible.

Préparer votre instance source

Vous devez préparer votre instance Redis ou Valkey autogérée pour pouvoir migrer vos charges de travail vers une instance Memorystore for Valkey cible.

Pour autoriser les connexions des nœuds de l'instance cible aux nœuds de l'instance source, procédez comme suit :

Si vous avez activé le mode protégé sur les nœuds sources, désactivez-le.
Si vous avez configuré les nœuds sources à l'aide d'une directive bind explicite, mettez à jour les nœuds pour autoriser les connexions entrantes provenant des nœuds cibles. Les nœuds cibles établissent des connexions à partir des adresses IP du sous-réseau du rattachement de réseau.
Mettez à jour les règles de pare-feu susceptibles de bloquer les connexions entrantes provenant des nœuds cibles.
Si vous avez activé l'authentification et le protocole TLS (Transport Layer Security) sur les nœuds sources, désactivez-les.

Pour permettre aux nœuds cibles d'établir la réplication avec les nœuds sources, procédez comme suit :

Ne renommez pas les commandes Valkey ou Redis qui modifient les données ou sont utilisées pour la réplication (par exemple, PING, PSYNC et HSET).
Si vous utilisez des listes de contrôle des accès (LCA) pour votre instance, autorisez les commandes suivantes pour l'utilisateur default afin que l'instance cible puisse établir la réplication :
- REPLCONF
- SYNC
- PSYNC
- PING
- INFO
- CLUSTER | NODES
Assurez-vous que l'instance source dispose d'une capacité de mémoire et de processeur suffisante pour gérer la charge de réplication supplémentaire des nœuds cibles.

Préparer l'instance cible

Pour garantir un processus de réplication fluide, vous devez dimensionner correctement votre instance Memorystore pour Valkey cible afin de gérer la charge de travail entrante de votre instance source. Pour ce faire, déterminez les spécifications exactes de votre instance cible. Ces spécifications incluent la compatibilité avec l'instance source, le mode cluster, le nombre de bases de données, le nombre de segments, la version de l'instance et le type de nœud.

Pour préparer l'instance cible, suivez les consignes ci-dessous :

Compatibilité avec l'instance source : les instances source et cible doivent se trouver dans les mêmes Google Cloud projet et région.
Mode cluster : le mode cluster de l'instance cible doit correspondre au mode cluster de l'instance source. Si le mode Cluster est désactivé sur l'instance source, il doit également l'être sur l'instance cible. Sinon, le mode Cluster doit être activé sur l'instance cible.
Nombre de bases de données : si le mode Cluster est désactivé sur l'instance cible, le nombre de bases de données logiques sur l'instance doit être supérieur ou égal au nombre de bases de données sur l'instance source.
Nombre de segments : si le mode Cluster est activé sur l'instance cible, le nombre de segments sur l'instance doit correspondre au nombre de segments sur l'instance source. Toutefois, le nombre d'instances répliquées sur les instances source et cible peut être différent.
Version de l'instance : la version de l'instance cible doit être compatible avec la version de l'instance source. Pour en savoir plus, consultez la section Compatibilité des versions.
Version de maintenance : la version de maintenance de l'instance cible doit être MEMORYSTORE_20260313_01_00 ou une version ultérieure. Pour en savoir plus, consultez À propos de la maintenance.
Type de nœud : le type de nœud de l'instance cible doit être suffisamment grand pour gérer les données qu'il reçoit des nœuds sources. Pour en savoir plus sur les types de nœuds que vous pouvez sélectionner pour l'instance cible et la capacité d'espace de clés correspondante pour chaque type de nœud, consultez Spécification du type de nœud.

Créer l'instance cible

Si vous ne disposez pas d'une instance cible répondant aux exigences pour recevoir les données que Memorystore pour Valkey migre depuis l'instance source, vous devez créer l'instance.

Pour créer cette instance, utilisez la console Google Cloud , la gcloud CLI ou l'API REST. Pour en savoir plus sur la création de l'instance, consultez Créer des instances.

Configurer un rattachement de réseau

Pour migrer les charges de travail d'une instance source vers une instance cible, les nœuds cibles doivent se connecter aux nœuds sources. Pour activer cette connexion, vous devez utiliser un rattachement de réseau. Les nœuds cibles établissent des connexions à partir du sous-réseau du réseau VPC de l'instance source qui est associé au rattachement de réseau.

Vous pouvez utiliser un rattachement de réseau qui répond aux exigences suivantes :

Il doit se trouver dans le même projet et la même région Google Cloud que l'instance cible.
Son sous-réseau doit se trouver dans le même réseau VPC que l'instance source.
Le sous-réseau de l'instance source doit disposer d'une plage d'adresses IP CIDR adéquate, compatible avec un minimum de N+1 adresses IP utilisables (où N est le nombre de nœuds dans l'instance cible). Par exemple, si une instance cible comporte trois segments et une instance répliquée, elle possède six nœuds : trois nœuds pour l'instance principale et trois nœuds pour l'instance répliquée. Par conséquent, vous devez disposer d'au moins sept adresses IP.
La plage de sous-réseaux ne peut pas chevaucher 10.0.0.0/23, car Memorystore pour Valkey réserve cette plage.

Si votre rattachement de réseau ne répond pas à ces exigences ou si vous n'en avez pas, vous devez en créer un. Pour en savoir plus, consultez Créer des rattachements de réseau.

Lancer la migration

Lorsque vous lancez la migration, l'instance cible établit la réplication avec l'instance source. L'instance cible réplique automatiquement toutes les données que votre application écrit dans l'instance source. L'instance cible devient une instance répliquée avec accès en lecture de l'instance source.

Pour démarrer la migration, utilisez la console Google Cloud , la gcloud CLI ou l'API REST.

Console

Dans la console Google Cloud , accédez à la page Memorystore pour Valkey.

Memorystore for Valkey
Cliquez sur l'ID de l'instance cible.
Sur la page Aperçu de l'instance, cliquez sur Lancer la migration.
Dans la fenêtre Migrer des instances Redis et Valkey autogérées, procédez comme suit :
Dans l'onglet Préparer, lisez les informations sur les conditions préalables pour l'instance source et les consignes concernant le rattachement de réseau. Cliquez ensuite sur Continuer.
Dans l'onglet Connect, procédez comme suit :
1. Saisissez l'adresse IP et le port de l'instance source. Vous avez noté ces informations dans Préparer votre instance source.
2. Sélectionnez le rattachement de réseau que vous souhaitez utiliser pour migrer les données.
3. Cliquez sur Continuer.
Dans l'onglet Vérifier, examinez les informations associées au processus de migration. Ces informations incluent l'ID de l'instance cible, l'adresse IP et le port de l'instance source, ainsi que le nom du rattachement de réseau. Après avoir vérifié ces informations, cliquez sur Lancer la migration.
Sur la page Instance en un coup d'œil, vérifiez que l'état Migration en cours s'affiche.

Si les nœuds cibles ne peuvent pas se connecter aux nœuds sources, ou si l'instance source ne peut pas répliquer les données vers l'instance cible, la migration échoue.

Dans ce cas, Memorystore pour Valkey rétablit l'instance cible à l'état dans lequel elle se trouvait avant le début du processus de migration. L'état de l'instance cible redevient Prêt, et l'instance dispose à nouveau de fonctionnalités de lecture et d'écriture.

Une fois que vous avez résolu les problèmes à l'origine de l'échec de la migration, vous pouvez la relancer.

gcloud

Utilisez la commande gcloud memorystore instances start-migration comme suit :

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

Effectuez les remplacements suivants :

INSTANCE_ID : ID de l'instance cible.
PROJECT_ID : ID ou numéro de projet du projetGoogle Cloud contenant cette instance.
REGION_ID : ID de la région où se trouve l'instance.
SOURCE_IP_ADDRESS : adresse IP de l'instance source. Vous avez noté cette adresse IP dans Préparer votre instance source.
SOURCE_PORT : numéro de port de l'instance source. Vous avez noté ce port dans Préparer votre instance source.
NETWORK_ATTACHMENT_ID : ID du rattachement de réseau.

Pour vérifier que la migration a bien démarré, utilisez la commande gcloud memorystore instances describe comme suit :

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

Vérifiez qu'un état MIGRATING s'affiche à côté du paramètre state.

Si les nœuds cibles ne peuvent pas se connecter aux nœuds sources, ou si l'instance source ne peut pas répliquer les données vers l'instance cible, la migration échoue.

Dans ce cas, Memorystore pour Valkey rétablit l'instance cible à l'état dans lequel elle se trouvait avant le début du processus de migration. L'état de l'instance cible redevient ACTIVE, et l'instance dispose à nouveau de fonctionnalités de lecture et d'écriture.

Une fois que vous avez résolu les problèmes à l'origine de l'échec de la migration, vous pouvez la relancer.

REST

Pour démarrer la migration, utilisez la commande d'API REST suivante.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant l'instance cible.
REGION_ID : ID de la région où se trouve cette instance.
INSTANCE_ID : ID de l'instance
SOURCE_IP_ADDRESS : adresse IP de l'instance source. Vous avez noté cette adresse IP dans Préparer votre instance source.
SOURCE_PORT : numéro de port de l'instance source. Vous avez noté ce port dans Préparer votre instance source.
NETWORK_ATTACHMENT_ID : ID du rattachement de réseau.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Surveiller la migration

Pour vous assurer que la migration se déroule sans problème, surveillez les instances source et cible.

Surveiller l'instance source

Sur l'instance source, vérifiez que l'utilisation du tampon de sortie client reste faible sur les nœuds sources. Pour vérifier l'utilisation du tampon, effectuez l'une des opérations suivantes :

Utiliser vos tableaux de bord de surveillance existants
Connectez-vous à votre instance source avec votre client Redis ou Valkey, puis exécutez la commande INFO CLIENTS pour vérifier les métriques du tampon de sortie.

Une utilisation faible et prolongée indique un décalage minimal et une synchronisation réussie des données de l'instance source vers l'instance cible.

Surveiller l'instance cible

Vous pouvez surveiller l'état de la migration de l'instance source vers Memorystore for Valkey. Pour ce faire, vérifiez la métrique État de la migration (/instance/migration_status) de l'instance cible pour vérifier que l'état actuel de l'instance est OPÉRATIONNEL. Cet état indique que les liens de réplication entre les segments des instances source et cible sont actifs et fonctionnent correctement pendant le processus de migration.

Pour vérifier la métrique État de la migration de l'instance à l'aide de la consoleGoogle Cloud , procédez comme suit :

Dans la console Google Cloud , accédez à la page Explorateur de métriques.

Explorateur de métriques
Dans le menu Métrique, sélectionnez la métrique État de la migration. Pour ce faire, sélectionnez Instance Memorystore > Instance > État de la migration, puis cliquez sur Appliquer.
Dans le champ Filtre, ajoutez le filtre suivant : instance_id = (equals) INSTANCE_ID.

Remplacez INSTANCE_ID par l'ID de l'instance cible.
Dans la section Résultats, vérifiez l'état actuel de l'instance. Si l'état HEALTHY s'affiche, l'instance fonctionne et vous pouvez terminer la migration.

Si l'état HEALTHY n'apparaît pas, vous pouvez utiliser la métrique État de la migration pour les nœuds principaux de l'instance cible. En surveillant ces nœuds, vous pouvez déterminer si un nœud spécifique n'est pas opérationnel.

Pour utiliser la métrique État de la migration pour les nœuds d'instance, procédez comme suit :
1. Dans le menu Métrique, sélectionnez la métrique État de la migration. Pour ce faire, sélectionnez Nœud d'instance Memorystore > Instance > État de la migration, puis cliquez sur Appliquer.
2. Dans le champ Filtre, ajoutez le filtre suivant : role = (equals) primary.
3. Dans la section Résultats, vérifiez que l'état actuel de tous les nœuds principaux est OPÉRATIONNEL. Si l'état est HEALTHY, les nœuds fonctionnent et vous pouvez terminer la migration.

Terminer la migration

Pour terminer la migration, utilisez la console Google Cloud , la gcloud CLI ou l'API REST.

Console

Dans la console Google Cloud , accédez à la page Memorystore pour Valkey.

Memorystore for Valkey
Cliquez sur l'ID de l'instance cible.
Sur la page Aperçu de l'instance, cliquez sur Terminer la migration.
Dans la boîte de dialogue Terminer la migration, procédez comme suit :
1. Si vous souhaitez vous assurer que l'instance cible réplique toutes les données de l'instance source, sélectionnez Standard.
  
  Attention : Si vous souhaitez basculer immédiatement le trafic de votre application vers l'instance cible, sélectionnez Forcer (ignorer la synchronisation). Toutefois, si vous sélectionnez cette option, il est possible que Memorystore pour Valkey ne soit pas en mesure de répliquer toutes les données de l'instance source vers l'instance cible.
2. Dans le champ de texte ID d'instance, saisissez l'ID de l'instance cible.
3. Cliquez sur Terminer la migration.
Sur la page Aperçu de l'instance, vérifiez que l'état Migré s'affiche.

gcloud

Utilisez la commande gcloud memorystore instances finish-migration comme suit :

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

Effectuez les remplacements suivants :

INSTANCE_ID : ID de l'instance cible
PROJECT_ID : ID ou numéro du projetGoogle Cloud contenant cette instance.
REGION_ID : ID de la région où se trouve l'instance.

Attention : Si vous souhaitez basculer immédiatement le trafic de votre application vers l'instance cible, utilisez le paramètre --force. Toutefois, si vous utilisez ce paramètre, il est possible que Memorystore pour Valkey ne soit pas en mesure de répliquer toutes les données de l'instance source vers l'instance cible.

Pour vérifier que la migration s'est terminée correctement, utilisez la commande gcloud memorystore instances describe comme suit :

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

Vérifiez qu'un état MIGRATED s'affiche à côté du paramètre state.

REST

Pour terminer la migration, utilisez la commande d'API REST suivante.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

PROJECT_ID : ID du projet Google Cloud contenant l'instance cible.
REGION_ID : ID de la région où se trouve cette instance.
INSTANCE_ID : ID de l'instance
FORCE_BOOLEAN (facultatif) : Ce paramètre détermine si Memorystore pour Valkey force la migration à se terminer immédiatement.
- Si vous définissez ce paramètre sur true, Memorystore pour Valkey termine immédiatement la migration afin que vous puissiez basculer le trafic de votre application vers l'instance cible. Il est toutefois possible que Memorystore for Valkey ne soit pas en mesure de répliquer toutes les données de l'instance source vers l'instance cible.
- Si vous définissez ce paramètre sur false, Memorystore for Valkey réplique toutes les données de l'instance source vers l'instance cible jusqu'à la fin de la migration.

Méthode HTTP et URL :

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

Corps JSON de la requête :

{
  "force": FORCE_BOOLEAN
}

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Migrer vos charges de travail Redis et Valkey vers Memorystore pour Valkey Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Compatibilité avec les versions

Avant de commencer

Utiliser la console Google Cloud , gcloud CLI et les API

Attribuer des rôles et des autorisations

Workflow pour migrer vos charges de travail

Préparer votre instance source

Préparer l'instance cible

Créer l'instance cible

Configurer un rattachement de réseau

Lancer la migration

Console

gcloud

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Surveiller la migration

Surveiller l'instance source

Surveiller l'instance cible

Terminer la migration

Console

gcloud

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Migrer vos charges de travail Redis et Valkey vers Memorystore pour Valkey