Criar instâncias

Nesta página, mostramos como criar instâncias de zona única e de várias zonas no Memorystore for Valkey.

Antes de começar

Siga as instruções da seção "Antes de começar":

  1. No console do Google Cloud , na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.


    Acessar o seletor de projetos
  2. Verifique se o faturamento foi ativado para o projeto. Saiba como verificar se o faturamento está ativado em um projeto.

  3. Instale e inicialize a Google Cloud CLI.

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

  4. Ativar a API Memorystore for Valkey
    Memorystore for Valkey
  5. Ative a API Network Connectivity
    API Network Connectivity
  6. Ative a API Service Consumer Management
    API Service Consumer Management

Outros pré-requisitos

  • Você precisa ter um destes papéis do IAM no projeto do Google Cloud que está sendo usado:
    • roles/memorystore.admin (o papel predefinido do IAM de administrador do Memorystore)
    • roles/owner (o papel básico do IAM de Proprietário)
    • roles/editor (o papel básico do IAM de Editor)

Configurar redes

Leia a página Rede para determinar se você precisa configurar uma política de conexão de serviço.

Se uma política de conexão de serviço não tiver sido criada para a rede em que você vai criar a instância do Valkey, siga as orientações de Rede para criá-la.

Criar uma instância de várias zonas

Nesta seção, mostramos como criar uma instância multizona.

Console

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

    Memorystore for Valkey

  2. Clique em Criar instância.

  3. Na seção Nomear sua instância, insira um ID para a instância. O ID da instância precisa usar apenas letras minúsculas, números e hifens. Ele também precisa começar com uma letra e ser exclusivo na região.

  4. No menu Região, selecione uma região para a instância.

  5. Na seção Disponibilidade por zona, selecione a opção Multizona porque você quer criar uma instância multizona.

  6. Na seção Modo de cluster, especifique se você quer uma instância com o modo de cluster ativado ou desativado. Para mais informações sobre esses tipos de instâncias, consulte Ativar e desativar o modo de cluster.

  7. Na seção Tipo de nó, selecione um tipo de nó.

  8. Na seção Tamanho da instância, insira o número de fragmentos da instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados da instância. Para mais informações sobre as especificações de instância, consulte Especificação de instância e nó.

  9. Se você quiser criar uma instância com réplicas, na seção Réplicas, selecione o número de réplicas (por fragmento). É possível selecionar de 0 a 5 réplicas. O valor padrão é 1 réplica.

  10. Na seção Configurar conexão, selecione a rede que os aplicativos podem usar para se conectar a essa instância. Para mais informações sobre rede privada para o Memorystore for Valkey, consulte Rede.

  11. Se você quiser aumentar a segurança da instância, na seção Segurança, siga um destes procedimentos:

    • Se você quiser ativar a autenticação do IAM, selecione a opção Autenticação do IAM. O Memorystore for Valkey usa a autenticação do IAM para restringir o acesso à instância.

    • Se você quiser ativar a autenticação básica baseada em token, selecione a opção Autenticação de token. O Memorystore para Valkey restringe o acesso à instância fazendo com que os clientes usem os tokens de autenticação para verificar as identidades nos aplicativos.

    • Se você não quiser ativar a autenticação do IAM ou a autenticação básica baseada em token, selecione a opção Desativado.

    Se você selecionar as opções Autenticação do IAM ou Autenticação de token, o Memorystore para Valkey vai marcar automaticamente a caixa de seleção Ativar criptografia em trânsito (TLS), e a seção Gerenciamento de autoridade certificadora será exibida. O Memorystore for Valkey criptografa suas credenciais para que elas sejam confidenciais quando transmitidas da instância para o aplicativo.

  12. Na seção Gerenciamento de autoridade certificadora, selecione a opção CA por instância, CA gerenciada pelo cliente ou CA compartilhada. Essas opções representam os modos de autoridade certificadora (AC) da sua instância. O modo de CA determina qual hierarquia de CA é usada para emitir os certificados digitais da instância.

    Se você selecionar a opção CA gerenciada pelo cliente, será necessário adicionar um pool de CAs. Um pool de CAs é uma coleção de várias CAs com uma política de emissão de certificados e uma política do Identity and Access Management (IAM) comuns. Um pool de CAs facilita o gerenciamento de rotação de CAs e permite que você alcance um total maior de consultas por segundo (QPS) efetivas.

    Para adicionar um pool de CAs, siga um destes procedimentos:

    1. Para adicionar um pool de CAs de outro projeto do Google Cloud , marque a caixa de seleção Adicionar CA de outro projeto e insira o ID do recurso do pool no campo de texto.

    2. Para adicionar um pool de CAs localizado no mesmo projeto do Google Cloud que você está usando para criar a instância, selecione o pool no menu Pool de CAs.

  13. Na seção Criptografia, selecione uma das seguintes opções:

    • Chave de criptografia gerenciada pelo Google: você quer que o Google use uma chave para criptografar os dados na instância. Essa é a criptografia padrão do Google.

    • Chave do Cloud KMS: você quer gerenciar a criptografia dos seus dados usando chaves de criptografia gerenciadas pelo cliente (CMEKs) no Cloud Key Management Service (Cloud KMS) com serviços integrados a CMEKs, como o Memorystore for Valkey.

      Se você selecionar essa opção, faça o seguinte:

      1. No menu Tipo de gerenciamento de chaves, selecione Cloud KMS.
      2. No menu Selecionar uma chave do Cloud KMS, escolha uma CMEK.

  14. Para atribuir uma política de ACL à instância, selecione uma política no menu Política na seção Política de ACL.

  15. Na seção Estratégia de persistência de dados, especifique como você quer que o Memorystore for Valkey mantenha os dados na instância. Os valores aceitáveis são Sem persistência, persistência de arquivo somente de anexação (AOF) e persistência de snapshot de memória.

  16. Se você quiser ativar os backups automatizados para sua instância, faça o seguinte:

    1. Marque a caixa de seleção Backups diários automatizados.
    2. No campo Dias para reter backups, insira o número de dias que você quer que o Memorystore for Valkey mantenha os backups antes que eles sejam excluídos automaticamente. É possível especificar de 1 a 365 dias. O valor padrão é 35 dias.
    3. No menu Janela de tempo, selecione um horário para o backup diário.

  17. Na seção Manutenção, selecione uma das seguintes opções:

    • Padrão: o Memorystore for Valkey atualiza sua instância de forma rotineira para garantir que o serviço seja confiável, eficiente, seguro e atualizado.
    • Personalizada: você quer personalizar a programação de manutenção da instância para se alinhar às necessidades do aplicativo e minimizar interrupções. Se você selecionar essa opção, especifique o dia em que quer que a manutenção ocorra e o horário em que quer que a janela de manutenção comece.

  18. Na seção Escolher versão, selecione sua versão do Valkey. As versões disponíveis são 7.2, 8.0, 9.0 e 9.1. A versão padrão é a 9.1.

  19. Clique em Criar instância.

gcloud

Para criar uma instância do Memorystore for Valkey, execute o 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

Substitua:

  • INSTANCE é o ID da instância do Memorystore for Valkey que você está criando. O ID da instância precisa ter de 1 a 63 caracteres e usar apenas letras minúsculas, números ou hifens. Ele precisa começar com uma letra minúscula e terminar com uma letra minúscula ou um número.

  • REGION_ID é a região em que você quer colocar a instância.

  • PROJECT_ID é o ID do projeto em que você quer criar sua instância.

  • NETWORK_ID é o ID da rede que você quer usar para criar sua instância.

  • REPLICA_COUNT é o número de réplicas (por fragmento). Os valores aceitos são 0-5.

  • NODE_TYPE é o tipo de nó que você quer usar para a instância.

  • ENGINE_VERSION é a versão da instância do Memorystore for Valkey. Os valores aceitos para esse parâmetro são VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 e VALKEY_9_1. Se você não especificar um valor, VALKEY_9_1 será o valor padrão.

  • SHARD_COUNT determina o número de fragmentos na instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados da instância. As instâncias com o modo de cluster desativado só aceitam um fragmento. Para mais informações, consulte Especificação de instância e nó.

  • ACL_POLICY_NAME é o nome da política de lista de controle de acesso (ACL) que você está atribuindo à instância que está criando. Ao usar políticas de ACL, é possível proteger o acesso à instância. É possível ativar a segurança refinada restringindo o acesso de usuários e serviços a chaves, comandos e canais do Pub/Sub específicos. Para mais informações, consulte Proteger o acesso às instâncias usando políticas de ACL.

  • MODE determina se você está criando uma instância com o modo de cluster ativado ou desativado. Se esse campo for omitido, a instância vai usar o modo de cluster ativado por padrão. Para mais informações, consulte Ativar e desativar o modo de cluster.

Exemplo:

Exemplo de modo de cluster ativado


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

Exemplo de modo de cluster desativado


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

Por padrão, a criptografia em trânsito está desativada, e a rede autorizada é default.

REST

Para criar uma instância de várias zonas, use o comando da API REST a seguir.

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

  • PROJECT_ID: o ID do projeto em que você quer criar a instância.

  • REGION_ID: a região em que você quer que a instância esteja localizada.

    Só é possível criar instâncias nas regiões compatíveis com o Memorystore for Valkey.

  • INSTANCE_ID: o ID da instância que você está criando. O ID da instância precisa ter de 1 a 63 caracteres e usar apenas letras minúsculas, números ou hifens. Ele precisa começar com uma letra minúscula e terminar com uma letra minúscula ou um número.
  • SHARD_COUNT: o número de fragmentos na instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados da instância. As instâncias com o modo de cluster desativado só aceitam um fragmento. Para mais informações, consulte Especificação de instância e nó.
  • REPLICA_COUNT: o número de réplicas (por fragmento). Os valores aceitos são de 0 a 5.

  • NODE_TYPE: o tipo de nó que você quer usar para a instância. Para mais informações, consulte Escolher um tipo de nó.

  • ENGINE_VERSION: a versão da instância. Os valores aceitos são VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 e VALKEY_9_1. Se você não especificar um valor, VALKEY_9_1 será o valor padrão.

  • MODE: o modo da instância. Esse valor determina se você está criando uma instância com o modo de cluster ativado ou desativado. Se você omitir esse valor, a instância vai usar o modo de cluster ativado por padrão. Para mais informações, consulte Ativar e desativar o modo de cluster.
  • ACL_POLICY_NAME: o nome da política de lista de controle de acesso (ACL) que você está atribuindo à instância que está criando. Ao usar políticas de ACL, é possível proteger o acesso à instância. É possível ativar a segurança detalhada restringindo o acesso de usuários e serviços a chaves, comandos e canais do Pub/Sub específicos. Para mais informações, consulte Proteger o acesso às instâncias usando políticas de ACL.
  • NETWORK_ID: o ID da rede da instância.

Método HTTP e URL: 

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

Corpo JSON da solicitação:

{
  "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 a solicitação, expanda uma destas opções:

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

Criar uma instância de zona única

Nesta seção, mostramos como criar uma instância de zona única.

Console

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

    Memorystore for Valkey

  2. Clique em Criar instância.

  3. Na seção Nomear sua instância, insira um ID para a instância. O ID da instância precisa usar apenas letras minúsculas, números e hifens. Ele também precisa começar com uma letra e ser exclusivo na região.

  4. No menu Região, selecione uma região para a instância.

  5. Na seção Disponibilidade por zona, faça o seguinte:

    1. Selecione a opção Zona única.

    2. No menu Zona, selecione a zona em que você quer que o Memorystore for Valkey crie a instância.

  6. Na seção Modo de cluster, especifique se você quer uma instância com o modo de cluster ativado ou desativado. Para mais informações sobre esses tipos de instâncias, consulte Ativar e desativar o modo de cluster.

  7. Na seção Tipo de nó, selecione um tipo de nó.

  8. Na seção Tamanho da instância, insira o número de fragmentos da instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados da instância. Para mais informações sobre as especificações de instância, consulte Especificação de instância e nó.

  9. Se você quiser criar uma instância com réplicas, na seção Réplicas, selecione o número de réplicas (por fragmento). É possível selecionar de 0 a 5 réplicas. O valor padrão é 1 réplica.

  10. Na seção Configurar conexão, selecione a rede que os aplicativos podem usar para se conectar a essa instância. Para mais informações sobre rede privada para o Memorystore for Valkey, consulte Rede.

  11. Se você quiser aumentar a segurança da instância, na seção Segurança, siga um destes procedimentos:

    • Se você quiser ativar a autenticação do IAM, selecione a opção Autenticação do IAM. O Memorystore for Valkey usa a autenticação do IAM para restringir o acesso à instância.

    • Se você quiser ativar a autenticação básica baseada em token, selecione a opção Autenticação de token. O Memorystore para Valkey restringe o acesso à instância fazendo com que os clientes usem os tokens de autenticação para verificar as identidades nos aplicativos.

    • Se você não quiser ativar a autenticação do IAM ou a autenticação básica baseada em token, selecione a opção Desativado.

    Se você selecionar as opções Autenticação do IAM ou Autenticação de token, o Memorystore para Valkey vai marcar automaticamente a caixa de seleção Ativar criptografia em trânsito (TLS), e a seção Gerenciamento de autoridade certificadora será exibida. O Memorystore for Valkey criptografa suas credenciais para que elas sejam confidenciais quando transmitidas da instância para o aplicativo.

  12. Na seção Gerenciamento de autoridade certificadora, selecione a opção CA por instância, CA gerenciada pelo cliente ou CA compartilhada. Essas opções representam os modos de autoridade certificadora (AC) da sua instância. O modo de CA determina qual hierarquia de CA é usada para emitir os certificados digitais da instância.

    Se você selecionar a opção CA gerenciada pelo cliente, será necessário adicionar um pool de CAs. Um pool de CAs é uma coleção de várias CAs com uma política de emissão de certificados e uma política do Identity and Access Management (IAM) comuns. Um pool de CAs facilita o gerenciamento de rotação de CAs e permite que você alcance um total maior de consultas por segundo (QPS) efetivas.

    Para adicionar um pool de CAs, siga um destes procedimentos:

    1. Para adicionar um pool de CAs de outro projeto do Google Cloud , marque a caixa de seleção Adicionar CA de outro projeto e insira o ID do recurso do pool no campo de texto.

    2. Para adicionar um pool de CAs localizado no mesmo projeto do Google Cloud que você está usando para criar a instância, selecione o pool no menu Pool de CAs.

  13. Na seção Criptografia, selecione uma das seguintes opções:

    • Chave de criptografia gerenciada pelo Google: você quer que o Google use uma chave para criptografar os dados na instância. Essa é a criptografia padrão do Google.

    • Chave do Cloud KMS: você quer gerenciar a criptografia dos seus dados usando chaves de criptografia gerenciadas pelo cliente (CMEKs) no Cloud Key Management Service (Cloud KMS) com serviços integrados a CMEKs, como o Memorystore for Valkey.

      Se você selecionar essa opção, faça o seguinte:

      1. No menu Tipo de gerenciamento de chaves, selecione Cloud KMS.
      2. No menu Selecionar uma chave do Cloud KMS, escolha uma CMEK.

  14. Para atribuir uma política de ACL à instância, selecione uma política no menu Política na seção Política de ACL.

  15. Na seção Estratégia de persistência de dados, especifique como você quer que o Memorystore for Valkey mantenha os dados na instância. Os valores aceitáveis são Sem persistência, persistência de arquivo somente de anexação (AOF) e persistência de snapshot de memória.

  16. Se você quiser ativar os backups automatizados para sua instância, faça o seguinte:

    1. Marque a caixa de seleção Backups diários automatizados.
    2. No campo Dias para reter backups, insira o número de dias que você quer que o Memorystore for Valkey mantenha os backups antes que eles sejam excluídos automaticamente. É possível especificar de 1 a 365 dias. O valor padrão é 35 dias.
    3. No menu Janela de tempo, selecione um horário para o backup diário.

  17. Na seção Manutenção, selecione uma das seguintes opções:

    • Padrão: o Memorystore for Valkey atualiza sua instância de forma rotineira para garantir que o serviço seja confiável, eficiente, seguro e atualizado.
    • Personalizada: você quer personalizar a programação de manutenção da instância para se alinhar às necessidades do aplicativo e minimizar interrupções. Se você selecionar essa opção, especifique o dia em que quer que a manutenção ocorra e o horário em que quer que a janela de manutenção comece.

  18. Na seção Escolher versão, selecione sua versão do Valkey. As versões disponíveis são 7.2, 8.0, 9.0 e 9.1. A versão padrão é a 9.1.

  19. Clique em Criar instância.

gcloud

Para criar uma instância de zona única, execute o 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

Substitua:

  • INSTANCE é o ID da instância do Memorystore for Valkey que você está criando. O ID da instância precisa ter de 1 a 63 caracteres e usar apenas letras minúsculas, números ou hifens. Ele precisa começar com uma letra minúscula e terminar com uma letra minúscula ou um número.

  • REGION_ID é a região em que você quer colocar a instância.

  • PROJECT_ID é o ID do projeto em que você quer criar sua instância.

  • NETWORK_ID é o ID da rede que você quer usar para criar sua instância.

  • REPLICA_COUNT é o número de réplicas (por fragmento). Os valores aceitos são 0-5.

  • NODE_TYPE é o tipo de nó que você quer usar para a instância.

  • ENGINE_VERSION é a versão da instância do Memorystore for Valkey. Os valores aceitos para esse parâmetro são VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 e VALKEY_9_1. Se você não especificar um valor, VALKEY_9_1 será o valor padrão.

  • SHARD_COUNT determina o número de fragmentos na instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados da instância. Se o modo selecionado for "Modo de cluster desativado", será possível especificar apenas um fragmento para a instância. Para mais informações, consulte Especificação de instância e nó.

  • ZONE_DISTRIBUTION_CONFIG_MODE é o modo que permite escolher entre provisionar uma instância de zona única ou de várias zonas. O padrão é multi-zone. Os valores aceitos são single-zone e multi-zone.

  • ZONE é a zona em que você quer provisionar os nós. Essa flag só será aplicável se você definir --zone-distribution-config-mode como single-zone.

  • ACL_POLICY_NAME é o nome da política de lista de controle de acesso (ACL) que você está atribuindo à instância que está criando. Ao usar políticas de ACL, é possível proteger o acesso à instância. É possível ativar a segurança refinada restringindo o acesso de usuários e serviços a chaves, comandos e canais do Pub/Sub específicos. Para mais informações, consulte Proteger o acesso às instâncias usando políticas de ACL.

  • MODE determina se você está criando uma instância com o modo de cluster ativado ou desativado. Se você omitir esse campo, o modo padrão será o Modo de cluster ativado. Para mais informações, consulte Ativar e desativar o modo de cluster.

REST

Para criar uma instância de zona única, use o comando da API REST a seguir.

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

  • PROJECT_ID: o ID do projeto em que você quer criar a instância.

  • REGION_ID: a região em que você quer que a instância esteja localizada.

    Só é possível criar instâncias nas regiões compatíveis com o Memorystore for Valkey.

  • INSTANCE_ID: o ID da instância que você está criando. O ID da instância precisa ter de 1 a 63 caracteres e usar apenas letras minúsculas, números ou hifens. Ele precisa começar com uma letra minúscula e terminar com uma letra minúscula ou um número.
  • SHARD_COUNT: o número de fragmentos na instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados da instância. As instâncias com o modo de cluster desativado só aceitam um fragmento. Para mais informações, consulte Especificação de instância e nó.
  • REPLICA_COUNT: o número de réplicas (por fragmento). Os valores aceitos são de 0 a 5.

  • NODE_TYPE: o tipo de nó que você quer usar para a instância. Para mais informações, consulte Escolher um tipo de nó.

  • ENGINE_VERSION: a versão da instância. Os valores aceitos são VALKEY_7_2, VALKEY_8_0, VALKEY_9_0 e VALKEY_9_1. Se você não especificar um valor, VALKEY_9_1 será o valor padrão.

  • MODE: o modo da instância. Esse valor determina se você está criando uma instância com o modo de cluster ativado ou desativado. Se você omitir esse valor, a instância vai usar o modo de cluster ativado por padrão. Para mais informações, consulte Ativar e desativar o modo de cluster.
  • ACL_POLICY_NAME: o nome da política de lista de controle de acesso (ACL) que você está atribuindo à instância que está criando. Ao usar políticas de ACL, é possível proteger o acesso à instância. É possível ativar a segurança detalhada restringindo o acesso de usuários e serviços a chaves, comandos e canais do Pub/Sub específicos. Para mais informações, consulte Proteger o acesso às instâncias usando políticas de ACL.
  • ZONE: a zona em que você quer criar a instância.
  • NETWORK_ID: o ID da rede da instância.

Método HTTP e URL: 

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

Corpo JSON da solicitação:

{
  "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 a solicitação, expanda uma destas opções:

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