Configures and manages Cloud Memorystore for Redis instances

Google Cloud Memorystore for Redis v1beta1

The redis.googleapis.com service implements the Google Cloud Memorystore for Redis API and defines the following resource model for managing Redis instances:

• The service works with a collection of cloud projects, named: /projects/*
• Each project has a collection of available locations, named: /locations/*
• Each location has a collection of Redis instances, named: /instances/*
• As such, Redis instances are resources of the form: /projects/{project_id}/locations/{location_id}/instances/{instance_id}

Note that location_id must be refering to a GCP region; for example:

• projects/redpepper-1290/locations/us-central1/instances/my-redis

Constructor.

Creates a Redis instance based on the specified tier and memory size.

By default, the instance is accessible from the project's default network <https://cloud.google.com/compute/docs/networks-and-firewalls#networks>__.

The creation is executed asynchronously and callers may check the returned operation to track its progress. Once the operation is completed the Redis instance will be fully functional. Completed longrunning.Operation will contain the new instance object in the response field.

The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

.. rubric:: Example

from google.cloud import redis_v1beta1 from google.cloud.redis_v1beta1 import enums

client = redis_v1beta1.CloudRedisClient()

parent = client.location_path('[PROJECT]', '[LOCATION]') instance_id = 'test_instance' tier = enums.Instance.Tier.BASIC memory_size_gb = 1 instance = {'tier': tier, 'memory_size_gb': memory_size_gb}

response = client.create_instance(parent, instance_id, instance)

def callback(operation_future): ... # Handle result. ... result = operation_future.result()

response.add_done_callback(callback)

Handle metadata.

metadata = response.metadata()

Deletes a specific Redis instance. Instance stops serving and data is deleted.

.. rubric:: Example

from google.cloud import redis_v1beta1

client = redis_v1beta1.CloudRedisClient()

name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')

response = client.delete_instance(name)

def callback(operation_future): ... # Handle result. ... result = operation_future.result()

response.add_done_callback(callback)

Handle metadata.

metadata = response.metadata()

Export Redis instance data into a Redis RDB format file in Cloud Storage.

Redis will continue serving during this operation.

The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

.. rubric:: Example

from google.cloud import redis_v1beta1

client = redis_v1beta1.CloudRedisClient()

TODO: Initialize name:

name = ''

TODO: Initialize output_config:

output_config = {}

response = client.export_instance(name, output_config)

def callback(operation_future): ... # Handle result. ... result = operation_future.result()

response.add_done_callback(callback)

Handle metadata.

metadata = response.metadata()

Initiates a failover of the master node to current replica node for a specific STANDARD tier Cloud Memorystore for Redis instance.

.. rubric:: Example

from google.cloud import redis_v1beta1

client = redis_v1beta1.CloudRedisClient()

name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')

response = client.failover_instance(name)

def callback(operation_future): ... # Handle result. ... result = operation_future.result()

response.add_done_callback(callback)

Handle metadata.

metadata = response.metadata()

Creates an instance of this client using the provided credentials file.

Creates an instance of this client using the provided credentials file.

Gets the details of a specific Redis instance.

.. rubric:: Example

from google.cloud import redis_v1beta1

client = redis_v1beta1.CloudRedisClient()

name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')

response = client.get_instance(name)

Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.

Redis may stop serving during this operation. Instance state will be IMPORTING for entire operation. When complete, the instance will contain only data from the imported file.

The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

.. rubric:: Example

from google.cloud import redis_v1beta1

client = redis_v1beta1.CloudRedisClient()

TODO: Initialize name:

name = ''

TODO: Initialize input_config:

input_config = {}

response = client.import_instance(name, input_config)

def callback(operation_future): ... # Handle result. ... result = operation_future.result()

response.add_done_callback(callback)

Handle metadata.

metadata = response.metadata()

Return a fully-qualified instance string.

Lists all Redis instances owned by a project in either the specified location (region) or all locations.

The location should have the following format:

• projects/{project_id}/locations/{location_id}

If location_id is specified as - (wildcard), then all regions available to the project are queried, and the results are aggregated.

.. rubric:: Example

from google.cloud import redis_v1beta1

client = redis_v1beta1.CloudRedisClient()

parent = client.location_path('[PROJECT]', '[LOCATION]')

Iterate over all results

for element in client.list_instances(parent): ... # process element ... pass

Alternatively:

Iterate over results one page at a time

for page in client.list_instances(parent).pages: ... for element in page: ... # process element ... pass

Return a fully-qualified location string.

Updates the metadata and configuration of a specific Redis instance.

Completed longrunning.Operation will contain the new instance object in the response field. The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

.. rubric:: Example

from google.cloud import redis_v1beta1

client = redis_v1beta1.CloudRedisClient()

paths_element = 'display_name' paths_element_2 = 'memory_size_gb' paths = [paths_element, paths_element_2] update_mask = {'paths': paths} display_name = 'UpdatedDisplayName' name = 'projects/

response = client.update_instance(update_mask, instance)

def callback(operation_future): ... # Handle result. ... result = operation_future.result()

response.add_done_callback(callback)

Handle metadata.

metadata = response.metadata()

Upgrades Redis instance to the newer Redis version specified in the request.

.. rubric:: Example

from google.cloud import redis_v1beta1

client = redis_v1beta1.CloudRedisClient()

name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')

TODO: Initialize redis_version:

redis_version = ''

response = client.upgrade_instance(name, redis_version)

def callback(operation_future): ... # Handle result. ... result = operation_future.result()

response.add_done_callback(callback)

Handle metadata.

metadata = response.metadata()