Method: projects.locations.instances.failover

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

HTTP request

POST https://redis.googleapis.com/v1/{name=projects/*/locations/*/instances/*}:failover

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. Redis instance resource name using the form: projects/{projectId}/locations/{locationId}/instances/{instanceId} where locationId refers to a GCP region.

Request body

The request body contains data with the following structure:

JSON representation
{
  "dataProtectionMode": enum(DataProtectionMode)
}
Fields
dataProtectionMode

enum(DataProtectionMode)

Optional. Available data protection modes that the user can choose. If it's unspecified, data protection mode will be LIMITED_DATA_LOSS by default.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

DataProtectionMode

Enums
DATA_PROTECTION_MODE_UNSPECIFIED Defaults to LIMITED_DATA_LOSS if a data protection mode is not specified.
LIMITED_DATA_LOSS Instance failover will be protected with data loss control. More specifically, the failover will only be performed if the current replication offset diff between master and replica is under a certain threshold.
FORCE_DATA_LOSS Instance failover will be performed without data loss control.
Kunde den här sidan hjälpa dig? Berätta:

Skicka feedback om ...

Google Cloud Memorystore for Redis