Create and manage Redis instances

Note: If you are looking for the Memorystore for Redis Cluster documentation,seeCreate instances.

This page describes how to use the Google Cloud console and the Google Cloud CLI tocreate and manageMemorystore for Redis instances.

For a list of the permissions you need to create and manage Redis instances,seeAccess control and permissions.

Create a Redis instance on a VPC network

To create a new instance:

Console

  1. Go to theMemorystore for Redis page in the Google Cloud console.

    Memorystore for Redis

  2. ClickCreate Instance.

    Memorystore UI

  3. On theCreate a Redis instance page, select your desiredconfigurations for your new instance.

  4. Click theCreate button.

gcloud

Enter the following command, replacingVARIABLES with appropriate values:

gcloud redis instances createINSTANCE_ID --size=SIZE --region=REGION_ID

Where:

  • INSTANCE_ID is the ID assigned to the instance.
  • SIZE is the size of the instance, in gibibytes (GiB).
  • REGION_ID is the region ID.

For example:

gcloud redis instances create myinstance --size=5 --region=us-central1

Instance creation requirements

Instance IDs must begin with a lowercase letter and may only includelowercase letters, hyphens, and numbers, with no spaces.

Optional flags

Redis version
Important: You can alsoupgradean existing Redis instance to a more recent OSS Redis version.

To choose one of theavailable OSS Redis versionsfor Memorystore for Redis, use the--redis-version flag with one of thefollowing values:

  • redis_7_2
  • redis_7_0 (Default)
  • redis_6_X
  • redis_5_0
  • redis_4_0
  • redis_3_2

For example:

gcloud redis instances create myinstance --size=5 --region=us-central1 \    --zone=us-central1-a --redis-version=redis_6_X
Networking

You can create Redis instances using one of twoconnection modes:--connect-mode=PRIVATE_SERVICE_ACCESS or--connect-mode=DIRECT_PEERING.We recommend that you use thePRIVATE_SERVICE_ACCESS connection mode.For more details, seeNetworking.

For instructions on using the--reserved-ip-range flag to specify a IPaddress range, seeCreating a Redis instance with a specific IP address range.

Redis AUTH

To enableAUTH,use the following flag:

--enable-auth

In-transit encryption

To enablein-transit encryption,use the following flag:

--transit-encryption-mode=SERVER_AUTHENTICATION

Standard tier

To create aStandard Tier instance, add--tier=STANDARDto the create command. The following command creates a Standard Tierinstance:

gcloud redis instances createINSTANCE_ID --size=SIZE --zone=ZONE --alternative-zone=ALTERNATIVE_ZONE --tier=STANDARD

For example:

gcloud redis instances create myinstance --size=5 --region=us-central1 --tier=standard

For more information about usinggcloud with Memorystore for Redis, see theGoogle Cloud CLI reference page.

Now your instance is created.

Create a Redis instance on a Shared VPC network from a service project

This section explains how to create a Redis instance in a service project usingthe Shared VPC network from the host project. This allows you to connect to yourRedis instance from resources in different projects connected to the same SharedVPC network. For more details, seeShared VPC overview.

Console

  1. Verify orestablisha private services access connection for the network in the host projectthat you use to create your Redis instance.

  2. Make sure theService Networking API is enabled for both the host project and the service project.

  3. Follow the steps fromCreating a Redis instance on a VPC network,but make the following modifications:

    1. Complete the optional step for setting up a private servicesaccess connection.

    2. To select the Shared VPC network from the host project, use theAuthorized VPC Network menu. This menu appears next toShared VPC Networks.

    Note: If you set up aprivate services access connection, but theNo existing IP ranges available status appears when you set an IP range name, thenadd the compute.globalAddresses.list permission to your account.

gcloud

Important: You mustEstablish a private services access connectionon the host project network before you can create a Redis instance with the--connect-mode=private-service-access flag listed below. Otherwise, thecreate operation fails. For more details, seeNetworking.

  1. Make sure theService Networking API is enabled for both the host project and the service project.

  2. Create a Redis instance in a service project using the Shared VPC from thehost project:

    gcloud redis instances createINSTANCE_ID --size=SIZE --region=REGION_ID --project=SERVICE_PROJECT_ID \  --network=projects/HOST_PROJECT_ID/global/networks/HOST_NETWORK_NAME \  --connect-mode=private-service-access

    Where:

    • INSTANCE_ID is the ID assigned to the instance.
    • SIZE is the size of the instance, in gibibytes (GiB).
    • REGION_ID is the region ID.
    • SERVICE_PROJECT_ID is the project ID for your service project.
    • HOST_PROJECT_ID is the project ID for your host project.
    • HOST_NETWORK_NAME is the name of your host project network.

    For example:

    gcloud redis instances create myinstance --size=5 --region=us-central1 --project=my-service-project \  --network=projects/my-host-project/global/networks/my-host-shared-vpc \  --connect-mode=private-service-access

Create a Redis instance that uses a centralized IP address range

Centralized IP address range management is provided by usingprivate servicesaccess. Private servicesaccess designates one IP address range that is used by multipleGoogle Cloud services. Using private services access removes the need tomanage a different IP address range for each service.

Console

  1. Verify orestablisha private service access connection for the network you use to createthe Redis instance.

  2. Follow the steps fromCreating a Redis instance on a VPC network,but make sure to complete the optional section on establishing a privateservices access connection.

gcloud

  1. Verify orestablisha private service access connection for the network you use to createthe Redis instance.

  2. Create a Redis instance using the network on which you established aprivate services access connection:

    gcloud redis instances createINSTANCE_ID --size=SIZE --region=REGION_ID --project=PROJECT_ID \  --network=projects/PROJECT_ID/global/networks/NETWORK_NAME \  --connect-mode=private-service-access

    Where:

    • INSTANCE_ID is the ID assigned to the instance.
    • SIZE is the size of the instance, in gibibytes (GiB).
    • REGION_ID is the region ID.
    • PROJECT_ID is the project ID.
    • NETWORK_NAME is the name of the network with which to createthe Redis instance.

    For example:

    gcloud redis instances create myinstance --size=5 --region=us-central1 --project=my-project \  --network=projects/my-project/global/networks/my-network \  --connect-mode=private-service-access

Create a Redis instance with a specific IP address range

The following instructions explain how to create a Redis instance from within anIP address range of your choosing.

Custom ranges with direct peering

If your project uses theDIRECT_PEERING connection mode, use the followingcommand to designate a specific IP address range when creating an instance:

gcloud redis instances createINSTANCE_ID --region=REGION --size=SIZE --connect-mode=DIRECT_PEERING --network=VPC_NETWORK_NAME --reserved-ip-range=RESERVED_RANGE

Where:

  • VPC_NETWORK_NAME is the name of the network used to create the instance.
  • RESERVED_RANGE is your desired custom range. For example,10.0.0.0/29.The minimum required block size is/29 for instances without read replicasand/28 for instances with read replicas. You can't use this flag todesignate multiple ranges with this connection mode.

For example:

gcloud redis instances create myinstance --region=us-central1 --size=1 --connect-mode=DIRECT_PEERING --network=default --reserved-ip-range=10.0.0.0/24

Custom ranges with private services access

If you only have one IP address rangeallocated for your private services access connection,that range is used by default for Memorystore instance creation.

If you havemultiple address ranges allocatedfor private services access, you can select which one to use with the followinggcloud command:

gcloud redis instances createINSTANCE_ID --region=REGION --size=SIZE --connect-mode=PRIVATE_SERVICE_ACCESS --network=VPC_NETWORK_NAME --reserved-ip-range=RESERVED_RANGE_NAME

Where:

  • VPC_NETWORK_NAME is the name of network used to create the instance.
  • RESERVED_RANGE_NAME is the name of the allocated IP addressrange(s). You can use this flag to specify the names of multiple rangeallocations with this connection mode. To do so, provide the names separatedby a comma.

For example:

gcloud redis instances create myinstance --region=us-central1 --size=1 --connect-mode=PRIVATE_SERVICE_ACCESS --network=default --reserved-ip-range=my-reserved-range-1,my-reserved-range-2

Create a Redis instance with read replicas

For instructions on how to create a Redis instance with read replicas, seeCreating a Redis instance with read replicas.

Create a Redis instance that uses customer managed encryption keys

For instructions on how to create a Redis instance that uses customer managedencryption keys (CMEK), seeCreating a Memorystore for Redis instance that uses CMEK.

List instances

You can list Memorystore for Redis instances by using either theGoogle Cloud console or thegcloud CLI.

Console

  1. In the Google Cloud console, go to theMemorystore for Redispage.

    Memorystore for Redis

    TheMemorystore for Redis page displays a list of your instances.

gcloud

To list instances, use thegcloud redis instances list command:

gcloud redis instances list \--region=REGION_ID

ReplaceREGION_ID with the region where the instances are located.

For example:

gcloud redis instances list \--region=us-central1

View instance information

You can view summary information about a Memorystore for Redis instance byusing either the Google Cloud console or thegcloud CLI.

Console

  1. In the Google Cloud console, go to theMemorystore for Redispage.

    Memorystore for Redis

  2. Click the ID of an instance about which you want to view summaryinformation.

gcloud

To view summary information about an instance, use thegcloud redis instances describecommand:

gcloud redis instances describeINSTANCE_ID \--region=REGION_ID

Make the following replacements:

  • INSTANCE_ID: the ID of the instance about which you want to viewsummary information
  • REGION_ID: the region where the instance is located

For example:

gcloud redis instances describe my-instance \--region=us-central1

Edit instances

To edit an instance:

Console

  1. Go to theMemorystore for Redis page in the Google Cloud console.

    Memorystore for Redis

  2. Click theInstance ID of the instance you'd like to edit.

  3. Click theEdit button

    1. From theEdit Redis instance page you can change an instance's:
      • Display name
      • Capacity
      • Configurations

  4. Click theSave button.

While your updates are being made, a spinning circle appears next to yourinstance on the Memorystore for Redis home page. When the updates arefinished, the circle becomes a green checkmark.

Gcloud

You can update the following properties after creating an instance:

  • Display name
  • Redis configuration
  • Labels
  • Size (For more information on scaling, seeScaling Instances.)

For example, enter the following command to update the display name of an instance, replacingVARIABLES with appropriate values:

gcloud redis instances updateINSTANCE_ID --region=REGION_ID --display-name=NEW_DISPLAY_NAME

For more details on how to set configuration parameters, seeConfiguring Redis Instances.

Delete instances

To delete an instance:

Console

  1. Go to theMemorystore for Redis page in the Google Cloud console.

    Memorystore for Redis

  2. To delete an instance, click its Instance ID.

  3. Click theDelete button.

  4. To confirm deletion, enter the instance's ID.

  5. Click delete again.

Gcloud

To delete an instance, enter the following command, replacingVARIABLES with appropriate values:

gcloud redis instances deleteINSTANCE_ID --region=REGION_ID

After the instance is deleted, it's removed from the list of instances on the Memorystore homepage.

What's next

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.