Créer des instances

Cette page explique comment créer des instances monozones et multizones dans Memorystore pour Valkey.

Avant de commencer

Suivez les instructions de la section "Avant de commencer" :

  1. Dans la console Google Cloud , sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu d'en sélectionner un existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

    Accéder au sélecteur de projet
  2. Assurez-vous que la facturation est activée pour votre projet. Découvrez comment vérifier si la facturation est activée sur un projet.

  3. Installez et initialisez la Google Cloud CLI.

    Remarque : Si vous avez déjà installé la gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update. Vous devez disposer au moins de la version 489.0.0 de gcloud CLI pour accéder aux commandes gcloud CLI de Memorystore pour Valkey.

  4. Activez l'API Memorystore pour Valkey.
    Memorystore pour Valkey
  5. Activez l'API Network Connectivity.
    API Network Connectivity
  6. Activez l'API Service Consumer Management.
    API Service Consumer Management

Autres conditions préalables

  • Vous devez disposer de l'un de ces rôles IAM dans le projet Google Cloud que vous utilisez :
    • roles/memorystore.admin (rôle IAM prédéfini d'administrateur Memorystore)
    • roles/owner (rôle IAM de base "Propriétaire")
    • roles/editor (rôle IAM de base "Éditeur")

Configurer la mise en réseau

Consultez la page Mise en réseau pour déterminer si vous devez configurer une règle de connexion de service.

Si aucune règle de connexion au service n'a été créée pour le réseau avec lequel vous allez créer l'instance Valkey, suivez les instructions de la section Mise en réseau pour la créer.

Créer une instance multizone

Cette section explique comment créer une instance multizone.

Console

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

    Memorystore for Valkey

  2. Cliquez sur Créer une instance.

  3. Dans la section Nommer votre instance, saisissez un ID pour l'instance. L'ID d'instance ne doit contenir que des lettres minuscules, des chiffres et des traits d'union. Il doit également commencer par une lettre et être unique dans sa région.

  4. Dans le menu Région, sélectionnez une région pour votre instance.

  5. Dans la section Disponibilité zonale, sélectionnez l'option Multizone, car vous souhaitez créer une instance multizone.

  6. Dans la section Mode Cluster, indiquez si vous souhaitez une instance en mode Cluster activé ou en mode Cluster désactivé. Pour en savoir plus sur ces types d'instances, consultez Activer et désactiver le mode cluster.

  7. Dans la section Type de nœud, sélectionnez un type de nœud.

  8. Dans la section Taille de l'instance, saisissez le nombre de segments pour votre instance. Le nombre de segments détermine la capacité de mémoire totale pour stocker les données de l'instance. Pour en savoir plus sur les spécifications des instances, consultez Spécifications des instances et des nœuds.

  9. Si vous souhaitez créer une instance avec des instances répliquées, sélectionnez le nombre d'instances répliquées (par segment) dans la section Instances répliquées. Vous pouvez sélectionner entre 0 et 5 instances répliquées. La valeur par défaut est de 1 instance répliquée.

  10. Dans la section Configurer la connexion, sélectionnez le réseau que vos applications peuvent utiliser pour se connecter à cette instance. Pour en savoir plus sur la mise en réseau privée pour Memorystore pour Valkey, consultez Mise en réseau.

  11. Si vous souhaitez renforcer la sécurité de votre instance, effectuez l'une des opérations suivantes dans la section Sécurité :

    • Si vous souhaitez activer l'authentification IAM, sélectionnez l'option Authentification IAM. Memorystore pour Valkey utilise l'authentification IAM pour restreindre l'accès à l'instance.

    • Si vous souhaitez activer l'authentification de base basée sur des jetons, sélectionnez l'option Authentification par jeton. Memorystore pour Valkey limite l'accès à l'instance en demandant aux clients d'utiliser leurs jetons d'authentification pour valider leur identité dans vos applications.

    • Si vous ne souhaitez pas activer l'authentification IAM ni l'authentification de base basée sur des jetons, sélectionnez l'option Désactivé.

    Si vous sélectionnez les options Authentification IAM ou Authentification par jeton, Memorystore pour Valkey coche automatiquement la case Activer le chiffrement en transit (TLS), et la section Gestion de l'autorité de certification s'affiche. Memorystore pour Valkey chiffre vos identifiants afin qu'ils restent confidentiels lorsqu'ils sont transmis de l'instance à l'application.

  12. Dans la section Gestion des autorités de certification, sélectionnez l'option Autorité de certification par instance, Autorité de certification gérée par le client ou Autorité de certification partagée. Ces options représentent les modes d'autorité de certification (CA) pour votre instance. Le mode CA détermine la hiérarchie d'autorités de certification utilisée pour émettre les certificats numériques de l'instance.

    Si vous sélectionnez l'option Autorité de certification gérée par le client, vous devez ajouter un pool d'autorités de certification. Un pool d'autorités de certification est une collection de plusieurs autorités de certification disposant d'une règle d'émission de certificats et d'une stratégie Identity and Access Management (IAM) communes. Un pool d'autorités de certification facilite la gestion de la rotation des autorités de certification et vous permet d'obtenir un nombre total de requêtes par seconde (RPS) plus élevé.

    Pour ajouter un pool d'autorités de certification, effectuez l'une des opérations suivantes :

    1. Pour ajouter un pool d'autorités de certification à partir d'un autre projet Google Cloud , cochez la case Ajouter une autorité de certification à partir d'un autre projet, puis saisissez l'ID de ressource du pool dans le champ de texte.

    2. Pour ajouter un pool d'autorités de certification situé dans le même projet Google Cloud que celui que vous utilisez pour créer l'instance, sélectionnez le pool dans le menu Pool d'autorités de certification.

  13. Dans la section Chiffrement, sélectionnez l'une des options suivantes :

    • Clé de chiffrement gérée par Google : vous souhaitez que Google utilise une clé pour chiffrer les données de l'instance. Il s'agit du chiffrement par défaut de Google.

    • Clé Cloud KMS : vous souhaitez gérer le chiffrement de vos données à l'aide de clés de chiffrement gérées par le client (CMEK) dans Cloud Key Management Service (Cloud KMS) avec des services intégrés aux CMEK, tels que Memorystore pour Valkey.

      Si vous sélectionnez cette option, procédez comme suit :

      1. Dans le menu Type de gestion des clés, sélectionnez Cloud KMS.
      2. Dans le menu Sélectionner une clé Cloud KMS, sélectionnez une clé CMEK.

  14. Pour attribuer une règle LCA à l'instance, sélectionnez une règle dans le menu Règle de la section Règle LCA.

  15. Dans la section Stratégie de persistance des données, spécifiez comment vous souhaitez que Memorystore pour Valkey conserve les données de votre instance. Les valeurs acceptées sont Aucune persistance, Persistance du fichier d'ajout uniquement (AOF) et Persistance de l'instantané de mémoire.

  16. Si vous souhaitez activer les sauvegardes automatiques pour votre instance, procédez comme suit :

    1. Cochez la case Sauvegardes quotidiennes automatiques.
    2. Dans le champ Jours de conservation des sauvegardes, saisissez le nombre de jours pendant lesquels vous souhaitez que Memorystore pour Valkey conserve les sauvegardes avant qu'elles ne soient supprimées automatiquement. Vous pouvez spécifier une valeur comprise entre 1 et 365 jours. La valeur par défaut est de 35 jours.
    3. Dans le menu Période, sélectionnez une heure pour la sauvegarde quotidienne.

  17. Dans la section Maintenance, sélectionnez l'une des options suivantes :

    • Par défaut : Memorystore pour Valkey met régulièrement à jour votre instance pour s'assurer que le service est fiable, performant, sécurisé et à jour.
    • Personnalisé : vous souhaitez personnaliser le calendrier de maintenance de votre instance pour l'adapter aux besoins de votre application et minimiser les perturbations. Si vous sélectionnez cette option, spécifiez le jour où vous souhaitez que la maintenance ait lieu et l'heure à laquelle vous souhaitez que l'intervalle de maintenance commence.

  18. Dans la section Choisir une version, sélectionnez votre version de Valkey. Les versions disponibles sont 7.2, 8.0, 9.0 et 9.1. La version par défaut est la version 9.1.

  19. Cliquez sur Créer une instance.

gcloud

Pour créer une instance Memorystore pour Valkey, exécutez la commande create :

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--acl-policy=ACL_POLICY_NAME \
--mode=MODE

Remplacez les éléments suivants :

  • INSTANCE est l'ID de l'instance Memorystore pour Valkey que vous créez. L'ID de votre instance doit comporter entre 1 et 63 caractères, et ne peut contenir que des lettres minuscules, des chiffres ou des traits d'union. Il doit commencer par une lettre minuscule et se terminer par une lettre minuscule ou un chiffre.

  • REGION_ID est la région dans laquelle vous souhaitez placer l'instance.

  • PROJECT_ID est l'ID du projet dans lequel vous souhaitez créer votre instance.

  • NETWORK_ID est l'ID du réseau que vous souhaitez utiliser pour créer votre instance.

  • REPLICA_COUNT est le nombre d'instances répliquées (par segment). Les valeurs acceptées sont comprises entre 0 et 5.

  • NODE_TYPE est le type de nœud que vous souhaitez utiliser pour l'instance.

  • ENGINE_VERSION est la version de votre instance Memorystore pour Valkey. Les valeurs acceptées pour ce paramètre sont VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 et VALKEY_9_1. Si vous ne spécifiez pas de valeur, VALKEY_9_1 est la valeur par défaut.

  • SHARD_COUNT détermine le nombre de segments dans votre instance. Le nombre de segments détermine la capacité de mémoire totale pour le stockage des données d'instance. Les instances avec le mode cluster désactivé n'acceptent qu'un seul segment. Pour en savoir plus, consultez Spécification des instances et des nœuds.

  • ACL_POLICY_NAME est le nom de la stratégie de liste de contrôle d'accès (LCA) que vous attribuez à l'instance que vous créez. En utilisant des règles LCA, vous pouvez sécuriser l'accès à l'instance. Vous pouvez activer une sécurité ultraprécise en limitant l'accès des utilisateurs et des services à des clés, des commandes et des canaux Pub/Sub spécifiques. Pour en savoir plus, consultez Sécuriser l'accès à vos instances à l'aide de règles de LCA.

  • MODE détermine si vous créez une instance en mode cluster activé ou en mode cluster désactivé. Si ce champ est omis, l'instance est définie par défaut sur le mode Cluster activé. Pour en savoir plus, consultez Activer et désactiver le mode Cluster.

Exemple :

Exemple de mode Cluster activé


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--replica-count=2 \
--node-type=highmem-medium \
--shard-count=8 \
--acl-policy=my-acl-policy \
--mode=cluster

Exemple de mode Cluster désactivé


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--shard-count=1 \
--replica-count=2 \
--node-type=highmem-medium \
--acl-policy=my-acl-policy \
--mode=cluster-disabled

Par défaut, le chiffrement en transit est désactivé et le réseau autorisé est default.

REST

Pour créer une instance multizone, 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 dans lequel vous souhaitez créer l'instance.

  • REGION_ID : région dans laquelle vous souhaitez placer l'instance.

    Vous ne pouvez créer des instances que dans les régions compatibles avec Memorystore pour Valkey.

  • INSTANCE_ID : ID de l'instance que vous créez. L'ID d'instance doit comporter entre 1 et 63 caractères, et ne peut contenir que des lettres minuscules, des chiffres ou des traits d'union. Il doit commencer par une lettre minuscule et se terminer par une lettre minuscule ou un chiffre.
  • SHARD_COUNT : nombre de segments dans l'instance. Le nombre de segments détermine la capacité de mémoire totale pour le stockage des données d'instance. Les instances avec le mode cluster désactivé n'acceptent qu'un seul segment. Pour en savoir plus, consultez Spécification des instances et des nœuds.
  • REPLICA_COUNT : nombre d'instances répliquées (par segment). Les valeurs acceptées sont comprises entre 0 et 5.

  • NODE_TYPE : type de nœud que vous souhaitez utiliser pour l'instance. Pour en savoir plus, consultez Choisir un type de nœud.

  • ENGINE_VERSION : version de l'instance. Les valeurs acceptées sont VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 et VALKEY_9_1. Si vous ne spécifiez pas de valeur, VALKEY_9_1 est la valeur par défaut.

  • MODE : mode de l'instance. Cette valeur détermine si vous créez une instance avec le mode Cluster activé ou désactivé. Si vous omettez cette valeur, l'instance est définie par défaut sur "Mode cluster activé". Pour en savoir plus, consultez Activer et désactiver le mode cluster.
  • ACL_POLICY_NAME : nom de la stratégie de liste de contrôle d'accès (LCA) que vous attribuez à l'instance que vous créez. Les règles LCA vous permettent de sécuriser l'accès à l'instance. Vous pouvez activer une sécurité ultraprécise en limitant l'accès des utilisateurs et des services à des clés, des commandes et des canaux Pub/Sub spécifiques. Pour en savoir plus, consultez Sécuriser l'accès à vos instances à l'aide de règles de LCA.
  • NETWORK_ID : ID du réseau de l'instance.

Méthode HTTP et URL : 

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances?instanceId=INSTANCE_ID

Corps JSON de la requête :

{
  "shardCount": SHARD_COUNT,
  "replicaCount": REPLICA_COUNT,
  "nodeType": "NODE_TYPE",
  "engineVersion": "ENGINE_VERSION",
  "mode": "MODE",
  "aclPolicy": "projects/PROJECT_ID/locations/REGION_ID/aclPolicies/ACL_POLICY_NAME",
  "endpoints": [
    {
      "connections": [
        {
          "pscAutoConnection": {
            "projectId": "PROJECT_ID",
            "network": "projects/PROJECT_ID/global/networks/NETWORK_ID"
          }
        }
      ]
    }
  ]
}

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

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": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Créer une instance à zone unique

Cette section explique comment créer une instance monozone.

Console

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

    Memorystore for Valkey

  2. Cliquez sur Créer une instance.

  3. Dans la section Nommer votre instance, saisissez un ID pour l'instance. L'ID d'instance ne doit contenir que des lettres minuscules, des chiffres et des traits d'union. Il doit également commencer par une lettre et être unique dans sa région.

  4. Dans le menu Région, sélectionnez une région pour votre instance.

  5. Dans la section Disponibilité zonale, procédez comme suit :

    1. Sélectionnez l'option Zone unique.

    2. Dans le menu Zone, sélectionnez la zone dans laquelle vous souhaitez que Memorystore pour Valkey crée l'instance.

  6. Dans la section Mode Cluster, indiquez si vous souhaitez une instance avec le mode Cluster activé ou désactivé. Pour en savoir plus sur ces types d'instances, consultez Activer et désactiver le mode cluster.

  7. Dans la section Type de nœud, sélectionnez un type de nœud.

  8. Dans la section Taille de l'instance, saisissez le nombre de segments pour votre instance. Le nombre de segments détermine la capacité de mémoire totale pour stocker les données de l'instance. Pour en savoir plus sur les spécifications des instances, consultez Spécifications des instances et des nœuds.

  9. Si vous souhaitez créer une instance avec des instances répliquées, sélectionnez le nombre d'instances répliquées (par segment) dans la section Instances répliquées. Vous pouvez sélectionner entre 0 et 5 instances répliquées. La valeur par défaut est de 1 instance répliquée.

  10. Dans la section Configurer la connexion, sélectionnez le réseau que vos applications peuvent utiliser pour se connecter à cette instance. Pour en savoir plus sur la mise en réseau privée pour Memorystore pour Valkey, consultez Mise en réseau.

  11. Si vous souhaitez renforcer la sécurité de votre instance, effectuez l'une des opérations suivantes dans la section Sécurité :

    • Si vous souhaitez activer l'authentification IAM, sélectionnez l'option Authentification IAM. Memorystore pour Valkey utilise l'authentification IAM pour restreindre l'accès à l'instance.

    • Si vous souhaitez activer l'authentification de base basée sur des jetons, sélectionnez l'option Authentification par jeton. Memorystore pour Valkey limite l'accès à l'instance en demandant aux clients d'utiliser leurs jetons d'authentification pour valider leur identité dans vos applications.

    • Si vous ne souhaitez pas activer l'authentification IAM ni l'authentification de base basée sur des jetons, sélectionnez l'option Désactivé.

    Si vous sélectionnez les options Authentification IAM ou Authentification par jeton, Memorystore pour Valkey coche automatiquement la case Activer le chiffrement en transit (TLS), et la section Gestion de l'autorité de certification s'affiche. Memorystore pour Valkey chiffre vos identifiants afin qu'ils restent confidentiels lorsqu'ils sont transmis de l'instance à l'application.

  12. Dans la section Gestion des autorités de certification, sélectionnez l'option Autorité de certification par instance, Autorité de certification gérée par le client ou Autorité de certification partagée. Ces options représentent les modes d'autorité de certification (CA) pour votre instance. Le mode CA détermine la hiérarchie d'autorités de certification utilisée pour émettre les certificats numériques de l'instance.

    Si vous sélectionnez l'option Autorité de certification gérée par le client, vous devez ajouter un pool d'autorités de certification. Un pool d'autorités de certification est une collection de plusieurs autorités de certification disposant d'une règle d'émission de certificats et d'une stratégie Identity and Access Management (IAM) communes. Un pool d'autorités de certification facilite la gestion de la rotation des autorités de certification et vous permet d'obtenir un nombre total de requêtes par seconde (RPS) plus élevé.

    Pour ajouter un pool d'autorités de certification, effectuez l'une des opérations suivantes :

    1. Pour ajouter un pool d'autorités de certification à partir d'un autre projet Google Cloud , cochez la case Ajouter une autorité de certification à partir d'un autre projet, puis saisissez l'ID de ressource du pool dans le champ de texte.

    2. Pour ajouter un pool d'autorités de certification situé dans le même projet Google Cloud que celui que vous utilisez pour créer l'instance, sélectionnez le pool dans le menu Pool d'autorités de certification.

  13. Dans la section Chiffrement, sélectionnez l'une des options suivantes :

    • Clé de chiffrement gérée par Google : vous souhaitez que Google utilise une clé pour chiffrer les données de l'instance. Il s'agit du chiffrement par défaut de Google.

    • Clé Cloud KMS : vous souhaitez gérer le chiffrement de vos données à l'aide de clés de chiffrement gérées par le client (CMEK) dans Cloud Key Management Service (Cloud KMS) avec des services intégrés aux CMEK, tels que Memorystore pour Valkey.

      Si vous sélectionnez cette option, procédez comme suit :

      1. Dans le menu Type de gestion des clés, sélectionnez Cloud KMS.
      2. Dans le menu Sélectionner une clé Cloud KMS, sélectionnez une clé CMEK.

  14. Pour attribuer une règle LCA à l'instance, sélectionnez une règle dans le menu Règle de la section Règle LCA.

  15. Dans la section Stratégie de persistance des données, spécifiez comment vous souhaitez que Memorystore pour Valkey conserve les données de votre instance. Les valeurs acceptées sont Aucune persistance, Persistance du fichier d'ajout uniquement (AOF) et Persistance de l'instantané de mémoire.

  16. Si vous souhaitez activer les sauvegardes automatiques pour votre instance, procédez comme suit :

    1. Cochez la case Sauvegardes quotidiennes automatiques.
    2. Dans le champ Jours de conservation des sauvegardes, saisissez le nombre de jours pendant lesquels vous souhaitez que Memorystore pour Valkey conserve les sauvegardes avant qu'elles ne soient supprimées automatiquement. Vous pouvez spécifier une valeur comprise entre 1 et 365 jours. La valeur par défaut est de 35 jours.
    3. Dans le menu Période, sélectionnez une heure pour la sauvegarde quotidienne.

  17. Dans la section Maintenance, sélectionnez l'une des options suivantes :

    • Par défaut : Memorystore pour Valkey met régulièrement à jour votre instance pour s'assurer que le service est fiable, performant, sécurisé et à jour.
    • Personnalisé : vous souhaitez personnaliser le calendrier de maintenance de votre instance pour l'adapter aux besoins de votre application et minimiser les perturbations. Si vous sélectionnez cette option, spécifiez le jour où vous souhaitez que la maintenance ait lieu et l'heure à laquelle vous souhaitez que l'intervalle de maintenance commence.

  18. Dans la section Choisir une version, sélectionnez votre version de Valkey. Les versions disponibles sont 7.2, 8.0, 9.0 et 9.1. La version par défaut est la version 9.1.

  19. Cliquez sur Créer une instance.

gcloud

Pour créer une instance monozone, exécutez la commande create :

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--zone-distribution-config-mode=ZONE_DISTRIBUTION_CONFIG_MODE \
--zone-distribution-config=ZONE \
--acl-policy=ACL_POLICY_NAME \
--mode=MODE

Remplacez les éléments suivants :

  • INSTANCE est l'ID de l'instance Memorystore pour Valkey que vous créez. L'ID de votre instance doit comporter entre 1 et 63 caractères, et ne peut contenir que des lettres minuscules, des chiffres ou des traits d'union. Il doit commencer par une lettre minuscule et se terminer par une lettre minuscule ou un chiffre.

  • REGION_ID est la région dans laquelle vous souhaitez placer l'instance.

  • PROJECT_ID est l'ID du projet dans lequel vous souhaitez créer votre instance.

  • NETWORK_ID est l'ID du réseau que vous souhaitez utiliser pour créer votre instance.

  • REPLICA_COUNT est le nombre d'instances répliquées (par segment). Les valeurs acceptées sont comprises entre 0 et 5.

  • NODE_TYPE est le type de nœud que vous souhaitez utiliser pour l'instance.

  • ENGINE_VERSION est la version de votre instance Memorystore pour Valkey. Les valeurs acceptées pour ce paramètre sont VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 et VALKEY_9_1. Si vous ne spécifiez pas de valeur, VALKEY_9_1 est la valeur par défaut.

  • SHARD_COUNT détermine le nombre de segments dans votre instance. Le nombre de segments détermine la capacité de mémoire totale pour le stockage des données d'instance. Si vous sélectionnez le mode cluster désactivé, vous ne pouvez spécifier qu'un seul segment pour votre instance. Pour en savoir plus, consultez Spécification des instances et des nœuds.

  • ZONE_DISTRIBUTION_CONFIG_MODE est le mode qui vous permet de choisir entre le provisionnement d'une instance à zone unique ou d'une instance multizone. La valeur par défaut est multi-zone. Les valeurs acceptées sont single-zone et multi-zone.

  • ZONE est la zone dans laquelle vous souhaitez provisionner vos nœuds. Cette option ne s'applique que si vous définissez --zone-distribution-config-mode sur single-zone.

  • ACL_POLICY_NAME est le nom de la stratégie de liste de contrôle d'accès (LCA) que vous attribuez à l'instance que vous créez. En utilisant des règles LCA, vous pouvez sécuriser l'accès à l'instance. Vous pouvez activer une sécurité ultraprécise en limitant l'accès des utilisateurs et des services à des clés, des commandes et des canaux Pub/Sub spécifiques. Pour en savoir plus, consultez Sécuriser l'accès à vos instances à l'aide de règles de LCA.

  • MODE détermine si vous créez une instance en mode cluster activé ou en mode cluster désactivé. Si vous omettez ce champ, le mode par défaut est "Mode Cluster activé". Pour en savoir plus, consultez Activer et désactiver le mode Cluster.

REST

Pour créer une instance monozone, 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 dans lequel vous souhaitez créer l'instance.

  • REGION_ID : région dans laquelle vous souhaitez placer l'instance.

    Vous ne pouvez créer des instances que dans les régions compatibles avec Memorystore pour Valkey.

  • INSTANCE_ID : ID de l'instance que vous créez. L'ID d'instance doit comporter entre 1 et 63 caractères, et ne peut contenir que des lettres minuscules, des chiffres ou des traits d'union. Il doit commencer par une lettre minuscule et se terminer par une lettre minuscule ou un chiffre.
  • SHARD_COUNT : nombre de segments dans l'instance. Le nombre de segments détermine la capacité de mémoire totale pour le stockage des données d'instance. Les instances avec le mode cluster désactivé n'acceptent qu'un seul segment. Pour en savoir plus, consultez Spécification des instances et des nœuds.
  • REPLICA_COUNT : nombre d'instances répliquées (par segment). Les valeurs acceptées sont comprises entre 0 et 5.

  • NODE_TYPE : type de nœud que vous souhaitez utiliser pour l'instance. Pour en savoir plus, consultez Choisir un type de nœud.

  • ENGINE_VERSION : version de l'instance. Les valeurs acceptées sont VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 et VALKEY_9_1. Si vous ne spécifiez pas de valeur, VALKEY_9_1 est la valeur par défaut.

  • MODE : mode de l'instance. Cette valeur détermine si vous créez une instance avec le mode Cluster activé ou désactivé. Si vous omettez cette valeur, l'instance est définie par défaut sur "Mode cluster activé". Pour en savoir plus, consultez Activer et désactiver le mode cluster.
  • ACL_POLICY_NAME : nom de la stratégie de liste de contrôle d'accès (LCA) que vous attribuez à l'instance que vous créez. Les règles LCA vous permettent de sécuriser l'accès à l'instance. Vous pouvez activer une sécurité ultraprécise en limitant l'accès des utilisateurs et des services à des clés, des commandes et des canaux Pub/Sub spécifiques. Pour en savoir plus, consultez Sécuriser l'accès à vos instances à l'aide de règles de LCA.
  • ZONE : zone dans laquelle vous souhaitez créer l'instance.
  • NETWORK_ID : ID du réseau de l'instance.

Méthode HTTP et URL : 

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances?instanceId=INSTANCE_ID

Corps JSON de la requête :

{
  "shardCount": SHARD_COUNT,
  "replicaCount": REPLICA_COUNT,
  "nodeType": "NODE_TYPE",
  "engineVersion": "ENGINE_VERSION",
  "mode": "MODE",
  "aclPolicy": "projects/PROJECT_ID/locations/REGION_ID/aclPolicies/ACL_POLICY_NAME",
  "zoneDistributionConfig": {
    "mode": "SINGLE_ZONE",
    "zone": "ZONE"
  },
  "endpoints": [
    {
      "connections": [
        {
          "pscAutoConnection": {
            "projectId": "PROJECT_ID",
            "network": "projects/PROJECT_ID/global/networks/NETWORK_ID"
          }
        }
      ]
    }
  ]
}

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

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": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}