Crea instancias

En esta página, se proporcionan instrucciones para crear instancias de una sola zona y de varias zonas en Memorystore para Valkey.

Antes de comenzar

Completa las instrucciones de la sección Antes de comenzar:

  1. En la consola de Google Cloud , en la página del selector de proyectos, selecciona o crea un proyecto de Google Cloud.

    Nota: Si no planeas conservar los recursos creados durante este procedimiento, crea un proyecto en lugar de seleccionar un proyecto existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.


    Ir al selector de proyectos
  2. Asegúrate de tener habilitada la facturación para tu proyecto. Obtén información para verificar si la facturación está habilitada en un proyecto.

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

    Nota: Si ya instalaste gcloud CLI, ejecuta gcloud components update para asegurarte de tener la versión más reciente. Necesitas, al menos, la versión 489.0.0 de gcloud CLI para acceder a los comandos de gcloud CLI de Memorystore para Valkey.

  4. Habilita la API de Memorystore para Valkey
    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

Otros requisitos

  • Debes tener uno de estos roles de IAM en el proyecto de Google Cloud que estás usando:
    • roles/memorystore.admin (el rol de IAM predefinido de administrador de Memorystore)
    • roles/owner (el rol básico de IAM de propietario)
    • roles/editor (el rol básico de IAM de editor)

Configura las herramientas de redes

Lee la página Herramientas de redes para determinar si necesitas configurar una política de conexión de servicio.

Si no se creó una política de conexión de servicio para la red con la que crearás la instancia de Valkey, sigue la guía de Herramientas de redes para crearla.

Crea una instancia multizona

En esta sección, se proporcionan instrucciones para crear una instancia multizona.

Console

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

    Memorystore for Valkey

  2. Haz clic en Crear instancia.

  3. En la sección Asigna un nombre a tu instancia, ingresa un ID para la instancia. El ID de la instancia debe usar solo letras minúsculas, números y guiones. También debe comenzar con una letra y ser único en su región.

  4. En el menú Región, selecciona una región para la instancia.

  5. En la sección Disponibilidad zonal, selecciona la opción Multizona, ya que deseas crear una instancia multizona.

  6. En la sección Modo de clúster, especifica si quieres una instancia con el modo de clúster habilitado o inhabilitado. Para obtener más información sobre estos tipos de instancias, consulta Habilita o inhabilita el modo de clúster.

  7. En la sección Tipo de nodo, selecciona un tipo de nodo.

  8. En la sección Tamaño de la instancia, ingresa la cantidad de fragmentos para tu instancia. El recuento de fragmentos determina la capacidad de memoria total para almacenar datos de la instancia. Para obtener más información sobre las especificaciones de las instancias, consulta Especificación de instancias y nodos.

  9. Si deseas crear una instancia con réplicas, en la sección Réplicas, selecciona la cantidad de réplicas (por fragmento). Puedes seleccionar entre 0 y 5 réplicas. El valor predeterminado es 1 réplica.

  10. En la sección Configurar conexión, selecciona la red que tus aplicaciones pueden usar para conectarse a esta instancia. Para obtener más información sobre las redes privadas de Memorystore para Valkey, consulta Herramientas de redes.

  11. Si deseas aumentar la seguridad de tu instancia, en la sección Seguridad, realiza una de las siguientes acciones:

    • Si deseas habilitar la autenticación de IAM, selecciona la opción Autenticación de IAM. Memorystore for Valkey usa la autenticación de IAM para restringir el acceso a la instancia.

    • Si quieres habilitar la autenticación básica basada en tokens, selecciona la opción Autenticación con token. Memorystore para Valkey restringe el acceso a la instancia haciendo que los clientes usen sus tokens de autenticación para verificar sus identidades dentro de tus aplicaciones.

    • Si no quieres habilitar la autenticación de IAM ni la autenticación básica basada en tokens, selecciona la opción Inhabilitada.

    Si seleccionas las opciones Autenticación de IAM o Autenticación de token, Memorystore for Valkey selecciona la casilla de verificación Habilitar la encriptación en tránsito (TLS) automáticamente y se muestra la sección Administración de la autoridad certificadora. Memorystore para Valkey encripta tus credenciales para que sean confidenciales cuando se transmitan de la instancia a la aplicación.

  12. En la sección Administración de la autoridad certificadora, selecciona la opción CA por instancia, CA administrada por el cliente o CA compartida. Estas opciones representan los modos de autoridad certificadora (AC) de tu instancia. El modo de AC determina qué jerarquía de AC se usa para emitir los certificados digitales de la instancia.

    Si seleccionas la opción AC administrada por el cliente, debes agregar un grupo de AC. Un grupo de AC es un conjunto de varias AC con una política común de emisión de certificados y de administración de Identity and Access Management (IAM). Un grupo de AC facilita la administración de la rotación de AC y te permite lograr un total de consultas por segundo (QPS) efectivas más alto.

    Para agregar un grupo de AC, realiza una de las siguientes acciones:

    1. Para agregar un grupo de AC de otro proyecto de Google Cloud , selecciona la casilla de verificación Agregar AC de otro proyecto y, luego, ingresa el ID del recurso para el grupo en el campo de texto.

    2. Para agregar un grupo de AC que se encuentre en el mismo proyecto de Google Cloud que el proyecto que usas para crear la instancia, selecciona el grupo en el menú Grupo de AC.

  13. En la sección Encriptación, selecciona una de las siguientes opciones:

    • Clave de encriptación administrada por Google: Deseas que Google use una clave para encriptar los datos de la instancia. Esta es la encriptación predeterminada de Google.

    • Clave de Cloud KMS: Deseas administrar la encriptación de tus datos con claves de encriptación administradas por el cliente (CMEK) en Cloud Key Management Service (Cloud KMS) con servicios integrados en CMEK, como Memorystore for Valkey.

      Si seleccionas esta opción, haz lo siguiente:

      1. En el menú Tipo de administración de claves, selecciona Cloud KMS.
      2. En el menú Selecciona una clave de Cloud KMS, elige una CMEK.

  14. Para asignar una política de LCA a la instancia, selecciona una política en el menú Política de la sección Política de LCA.

  15. En la sección Estrategia de persistencia de datos, especifica cómo quieres que Memorystore for Valkey conserve los datos en tu instancia. Los valores aceptables son Sin persistencia, persistencia de archivo de solo anexión (AOF) y persistencia de instantánea de memoria.

  16. Si deseas habilitar las copias de seguridad automatizadas para tu instancia, haz lo siguiente:

    1. Selecciona la casilla de verificación Copias de seguridad diarias automáticas.
    2. En el campo Días para conservar las copias de seguridad, ingresa la cantidad de días que deseas que Memorystore para Valkey conserve las copias de seguridad antes de que se borren automáticamente. Puedes especificar de 1 a 365 días. El valor predeterminado es 35 días.
    3. En el menú Período, selecciona una hora para la copia de seguridad diaria.

  17. En la sección Mantenimiento, selecciona una de las siguientes opciones:

    • Predeterminado: Memorystore for Valkey actualiza tu instancia de forma rutinaria para garantizar que el servicio sea confiable, eficaz, seguro y esté actualizado.
    • Personalizado: Deseas personalizar el programa de mantenimiento de tu instancia para que se alinee con las necesidades de tu aplicación y minimizar las interrupciones. Si seleccionas esta opción, especifica el día en que deseas que se realice el mantenimiento y la hora en que deseas que comience el período de mantenimiento.

  18. En la sección Elige la versión, selecciona tu versión de Valkey. Las versiones disponibles son 7.2, 8.0, 9.0 y 9.1. La versión predeterminada es la 9.1.

  19. Haz clic en Crear instancia.

gcloud

Para crear una instancia de Memorystore para Valkey, ejecuta el comando 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

Reemplaza lo siguiente:

  • INSTANCE es el ID de la instancia de Memorystore para Valkey que estás creando. El ID de la instancia debe tener entre 1 y 63 caracteres, y solo puede incluir letras minúsculas, números o guiones. Debe empezar con una letra minúscula y terminar con una letra minúscula o un número.

  • REGION_ID es la región en la que deseas colocar la instancia.

  • PROJECT_ID es el ID del proyecto en el que deseas crear tu instancia.

  • NETWORK_ID es el ID de la red que deseas usar para crear tu instancia.

  • REPLICA_COUNT es la cantidad de réplicas (por fragmento). Los valores aceptados son 0-5.

  • NODE_TYPE es el tipo de nodo que deseas usar para la instancia.

  • ENGINE_VERSION es la versión de tu instancia de Memorystore para Valkey. Los valores aceptados para este parámetro son VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 y VALKEY_9_1. Si no especificas un valor, VALKEY_9_1 es el valor predeterminado.

  • SHARD_COUNT determina la cantidad de fragmentos en tu instancia. El recuento de fragmentos determina la capacidad de memoria total para almacenar datos de la instancia. Las instancias con el modo de clúster inhabilitado solo admiten un fragmento. Para obtener más información, consulta Especificación de instancias y nodos.

  • ACL_POLICY_NAME es el nombre de la política de lista de control de acceso (LCA) que asignas a la instancia que estás creando. Con las políticas de ACL, puedes proteger el acceso a la instancia. Puedes habilitar la seguridad detallada restringiendo el acceso de los usuarios y servicios a claves, comandos y canales de Pub/Sub específicos. Para obtener más información, consulta Protege el acceso a tus instancias con políticas de LCA.

  • MODE determina si estás creando una instancia con el modo de clúster habilitado o con el modo de clúster inhabilitado. Si se omite este campo, la instancia se establece de forma predeterminada en Modo de clúster habilitado. Para obtener más información, consulta Habilita e inhabilita el modo de clúster.

Por ejemplo:

Ejemplo de modo de clúster habilitado


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

Ejemplo de modo de clúster inhabilitado


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

De forma predeterminada, la encriptación en tránsito está inhabilitada y la red autorizada es default.

REST

Para crear una instancia de varias zonas, 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 en el que deseas crear la instancia.

  • REGION_ID: Es la región en la que deseas que se ubique la instancia.

    Solo puedes crear instancias en las regiones admitidas para Memorystore para Valkey.

  • INSTANCE_ID: Es el ID de la instancia que crearás. El ID de la instancia debe tener entre 1 y 63 caracteres, y solo puede incluir letras minúsculas, números o guiones. Debe empezar con una letra minúscula y terminar con una letra minúscula o un número.
  • SHARD_COUNT: Es la cantidad de fragmentos en la instancia. El recuento de fragmentos determina la capacidad de memoria total para almacenar datos de la instancia. Las instancias con el modo de clúster inhabilitado solo admiten un fragmento. Para obtener más información, consulta Especificación de instancias y nodos.
  • REPLICA_COUNT: Es la cantidad de réplicas (por fragmento). Los valores aceptados son de 0 a 5.

  • NODE_TYPE: Es el tipo de nodo que deseas usar para la instancia. Para obtener más información, consulta Elige un tipo de nodo.

  • ENGINE_VERSION: la versión de la instancia. Los valores aceptados son VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 y VALKEY_9_1. Si no especificas un valor, VALKEY_9_1 es el valor predeterminado.

  • MODE: Es el modo de la instancia. Este valor determina si estás creando una instancia con el modo de clúster habilitado o inhabilitado. Si omites este valor, la instancia se establece de forma predeterminada en el modo de clúster habilitado. Para obtener más información, consulta Habilita o inhabilita el modo de clúster.
  • ACL_POLICY_NAME: Es el nombre de la política de lista de control de acceso (LCA) que asignas a la instancia que estás creando. Con las políticas de LCA, puedes proteger el acceso a la instancia. Puedes habilitar la seguridad detallada restringiendo el acceso de los usuarios y servicios a claves, comandos y canales de Pub/Sub específicos. Para obtener más información, consulta Protege el acceso a tus instancias con políticas de ACL.
  • NETWORK_ID: Es el ID de la red de la instancia.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

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

Crea una instancia de una sola zona

En esta sección, se proporcionan instrucciones para crear una instancia de zona única.

Console

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

    Memorystore for Valkey

  2. Haz clic en Crear instancia.

  3. En la sección Asigna un nombre a tu instancia, ingresa un ID para la instancia. El ID de la instancia debe usar solo letras minúsculas, números y guiones. También debe comenzar con una letra y ser único en su región.

  4. En el menú Región, selecciona una región para la instancia.

  5. En la sección Disponibilidad zonal, haz lo siguiente:

    1. Selecciona la opción Zona única.

    2. En el menú Zona, selecciona la zona en la que deseas que Memorystore para Valkey cree la instancia.

  6. En la sección Modo de clúster, especifica si quieres una instancia con el modo de clúster habilitado o inhabilitado. Para obtener más información sobre estos tipos de instancias, consulta Habilita o inhabilita el modo de clúster.

  7. En la sección Tipo de nodo, selecciona un tipo de nodo.

  8. En la sección Tamaño de la instancia, ingresa la cantidad de fragmentos para tu instancia. El recuento de fragmentos determina la capacidad de memoria total para almacenar datos de la instancia. Para obtener más información sobre las especificaciones de las instancias, consulta Especificación de instancias y nodos.

  9. Si deseas crear una instancia con réplicas, en la sección Réplicas, selecciona la cantidad de réplicas (por fragmento). Puedes seleccionar entre 0 y 5 réplicas. El valor predeterminado es 1 réplica.

  10. En la sección Configurar conexión, selecciona la red que tus aplicaciones pueden usar para conectarse a esta instancia. Para obtener más información sobre las redes privadas de Memorystore para Valkey, consulta Herramientas de redes.

  11. Si deseas aumentar la seguridad de tu instancia, en la sección Seguridad, realiza una de las siguientes acciones:

    • Si deseas habilitar la autenticación de IAM, selecciona la opción Autenticación de IAM. Memorystore for Valkey usa la autenticación de IAM para restringir el acceso a la instancia.

    • Si quieres habilitar la autenticación básica basada en tokens, selecciona la opción Autenticación con token. Memorystore para Valkey restringe el acceso a la instancia haciendo que los clientes usen sus tokens de autenticación para verificar sus identidades dentro de tus aplicaciones.

    • Si no quieres habilitar la autenticación de IAM ni la autenticación básica basada en tokens, selecciona la opción Inhabilitada.

    Si seleccionas las opciones Autenticación de IAM o Autenticación de token, Memorystore for Valkey selecciona la casilla de verificación Habilitar la encriptación en tránsito (TLS) automáticamente y se muestra la sección Administración de la autoridad certificadora. Memorystore para Valkey encripta tus credenciales para que sean confidenciales cuando se transmitan de la instancia a la aplicación.

  12. En la sección Administración de la autoridad certificadora, selecciona la opción CA por instancia, CA administrada por el cliente o CA compartida. Estas opciones representan los modos de autoridad certificadora (AC) de tu instancia. El modo de AC determina qué jerarquía de AC se usa para emitir los certificados digitales de la instancia.

    Si seleccionas la opción AC administrada por el cliente, debes agregar un grupo de AC. Un grupo de AC es un conjunto de varias AC con una política común de emisión de certificados y de administración de Identity and Access Management (IAM). Un grupo de AC facilita la administración de la rotación de AC y te permite lograr un total de consultas por segundo (QPS) efectivas más alto.

    Para agregar un grupo de AC, realiza una de las siguientes acciones:

    1. Para agregar un grupo de AC de otro proyecto de Google Cloud , selecciona la casilla de verificación Agregar AC de otro proyecto y, luego, ingresa el ID del recurso para el grupo en el campo de texto.

    2. Para agregar un grupo de AC que se encuentre en el mismo proyecto de Google Cloud que el proyecto que usas para crear la instancia, selecciona el grupo en el menú Grupo de AC.

  13. En la sección Encriptación, selecciona una de las siguientes opciones:

    • Clave de encriptación administrada por Google: Deseas que Google use una clave para encriptar los datos de la instancia. Esta es la encriptación predeterminada de Google.

    • Clave de Cloud KMS: Deseas administrar la encriptación de tus datos con claves de encriptación administradas por el cliente (CMEK) en Cloud Key Management Service (Cloud KMS) con servicios integrados en CMEK, como Memorystore for Valkey.

      Si seleccionas esta opción, haz lo siguiente:

      1. En el menú Tipo de administración de claves, selecciona Cloud KMS.
      2. En el menú Selecciona una clave de Cloud KMS, elige una CMEK.

  14. Para asignar una política de LCA a la instancia, selecciona una política en el menú Política de la sección Política de LCA.

  15. En la sección Estrategia de persistencia de datos, especifica cómo quieres que Memorystore for Valkey conserve los datos en tu instancia. Los valores aceptables son Sin persistencia, persistencia de archivo de solo anexión (AOF) y persistencia de instantánea de memoria.

  16. Si deseas habilitar las copias de seguridad automatizadas para tu instancia, haz lo siguiente:

    1. Selecciona la casilla de verificación Copias de seguridad diarias automáticas.
    2. En el campo Días para conservar las copias de seguridad, ingresa la cantidad de días que deseas que Memorystore para Valkey conserve las copias de seguridad antes de que se borren automáticamente. Puedes especificar de 1 a 365 días. El valor predeterminado es 35 días.
    3. En el menú Período, selecciona una hora para la copia de seguridad diaria.

  17. En la sección Mantenimiento, selecciona una de las siguientes opciones:

    • Predeterminado: Memorystore for Valkey actualiza tu instancia de forma rutinaria para garantizar que el servicio sea confiable, eficaz, seguro y esté actualizado.
    • Personalizado: Deseas personalizar el programa de mantenimiento de tu instancia para que se alinee con las necesidades de tu aplicación y minimizar las interrupciones. Si seleccionas esta opción, especifica el día en que deseas que se realice el mantenimiento y la hora en que deseas que comience el período de mantenimiento.

  18. En la sección Elige la versión, selecciona tu versión de Valkey. Las versiones disponibles son 7.2, 8.0, 9.0 y 9.1. La versión predeterminada es la 9.1.

  19. Haz clic en Crear instancia.

gcloud

Para crear una instancia de una sola zona, ejecuta el comando 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

Reemplaza lo siguiente:

  • INSTANCE es el ID de la instancia de Memorystore para Valkey que estás creando. El ID de la instancia debe tener entre 1 y 63 caracteres, y solo puede incluir letras minúsculas, números o guiones. Debe empezar con una letra minúscula y terminar con una letra minúscula o un número.

  • REGION_ID es la región en la que deseas colocar la instancia.

  • PROJECT_ID es el ID del proyecto en el que deseas crear tu instancia.

  • NETWORK_ID es el ID de la red que deseas usar para crear tu instancia.

  • REPLICA_COUNT es la cantidad de réplicas (por fragmento). Los valores aceptados son 0-5.

  • NODE_TYPE es el tipo de nodo que deseas usar para la instancia.

  • ENGINE_VERSION es la versión de tu instancia de Memorystore para Valkey. Los valores aceptados para este parámetro son VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 y VALKEY_9_1. Si no especificas un valor, VALKEY_9_1 es el valor predeterminado.

  • SHARD_COUNT determina la cantidad de fragmentos en tu instancia. El recuento de fragmentos determina la capacidad de memoria total para almacenar datos de instancia. Si el modo que seleccionas es Modo de clúster inhabilitado, solo puedes especificar un fragmento para tu instancia. Para obtener más información, consulta Especificación de instancias y nodos.

  • ZONE_DISTRIBUTION_CONFIG_MODE es el modo que te permite elegir entre aprovisionar una instancia de zona única o una instancia multizona. El valor predeterminado multi-zone. Los valores aceptados son single-zone y multi-zone.

  • ZONE es la zona en la que deseas aprovisionar tus nodos. Esta marca solo se aplica si configuras --zone-distribution-config-mode como single-zone.

  • ACL_POLICY_NAME es el nombre de la política de lista de control de acceso (LCA) que asignas a la instancia que estás creando. Con las políticas de ACL, puedes proteger el acceso a la instancia. Puedes habilitar la seguridad detallada restringiendo el acceso de los usuarios y servicios a claves, comandos y canales de Pub/Sub específicos. Para obtener más información, consulta Protege el acceso a tus instancias con políticas de LCA.

  • MODE determina si estás creando una instancia con el modo de clúster habilitado o con el modo de clúster inhabilitado. Si omites este campo, el modo predeterminado será Modo de clúster habilitado. Para obtener más información, consulta Habilita e inhabilita el modo de clúster.

REST

Para crear una instancia de una sola zona, 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 en el que deseas crear la instancia.

  • REGION_ID: Es la región en la que deseas que se ubique la instancia.

    Solo puedes crear instancias en las regiones admitidas para Memorystore para Valkey.

  • INSTANCE_ID: Es el ID de la instancia que crearás. El ID de la instancia debe tener entre 1 y 63 caracteres, y solo puede incluir letras minúsculas, números o guiones. Debe empezar con una letra minúscula y terminar con una letra minúscula o un número.
  • SHARD_COUNT: Es la cantidad de fragmentos en la instancia. El recuento de fragmentos determina la capacidad de memoria total para almacenar datos de la instancia. Las instancias con el modo de clúster inhabilitado solo admiten un fragmento. Para obtener más información, consulta Especificación de instancias y nodos.
  • REPLICA_COUNT: Es la cantidad de réplicas (por fragmento). Los valores aceptados son de 0 a 5.

  • NODE_TYPE: Es el tipo de nodo que deseas usar para la instancia. Para obtener más información, consulta Elige un tipo de nodo.

  • ENGINE_VERSION: la versión de la instancia. Los valores aceptados son VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 y VALKEY_9_1. Si no especificas un valor, VALKEY_9_1 es el valor predeterminado.

  • MODE: Es el modo de la instancia. Este valor determina si estás creando una instancia con el modo de clúster habilitado o inhabilitado. Si omites este valor, la instancia se establece de forma predeterminada en el modo de clúster habilitado. Para obtener más información, consulta Habilita o inhabilita el modo de clúster.
  • ACL_POLICY_NAME: Es el nombre de la política de lista de control de acceso (LCA) que asignas a la instancia que estás creando. Con las políticas de LCA, puedes proteger el acceso a la instancia. Puedes habilitar la seguridad detallada restringiendo el acceso de los usuarios y servicios a claves, comandos y canales de Pub/Sub específicos. Para obtener más información, consulta Protege el acceso a tus instancias con políticas de ACL.
  • ZONE: Es la zona en la que deseas crear la instancia.
  • NETWORK_ID: Es el ID de la red de la instancia.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

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