Managed Service for Redis API, gRPC: ClusterService.StartFailover

Written by

Yandex Cloud

Updated at October 28, 2024

gRPC request
StartClusterFailoverRequest
operation.Operation
StartClusterFailoverMetadata
Cluster
Monitoring
ClusterConfig
RedisConfigSet5_0
RedisConfig5_0
ClientOutputBufferLimit
RedisConfigSet6_0
RedisConfig6_0
ClientOutputBufferLimit
RedisConfigSet6_2
RedisConfig6_2
ClientOutputBufferLimit
RedisConfigSet7_0
RedisConfig7_0
ClientOutputBufferLimit
Resources
Access
RedisConfigSet
RedisConfig
ClientOutputBufferLimit
DiskSizeAutoscaling
MaintenanceWindow
AnytimeMaintenanceWindow
WeeklyMaintenanceWindow
MaintenanceOperation

Start a manual failover on the specified Redis cluster.

gRPC request

rpc StartFailover (StartClusterFailoverRequest) returns (operation.Operation)

StartClusterFailoverRequest

{
  "clusterId": "string",
  "hostNames": [
    "string"
  ]
}

Field

Description

clusterId

string

Required field. ID of the Redis cluster to start failover on.

hostNames[]

string

List of hostnames which should not be masters. Can be empty for sentinel clusters or can contain multiple hosts for sharded clusters.

operation.Operation

{
  "id": "string",
  "description": "string",
  "createdAt": "google.protobuf.Timestamp",
  "createdBy": "string",
  "modifiedAt": "google.protobuf.Timestamp",
  "done": "bool",
  "metadata": {
    "clusterId": "string",
    "hostNames": [
      "string"
    ]
  },
  // Includes only one of the fields `error`, `response`
  "error": "google.rpc.Status",
  "response": {
    "id": "string",
    "folderId": "string",
    "createdAt": "google.protobuf.Timestamp",
    "name": "string",
    "description": "string",
    "labels": "string",
    "environment": "Environment",
    "monitoring": [
      {
        "name": "string",
        "description": "string",
        "link": "string"
      }
    ],
    "config": {
      "version": "string",
      // Includes only one of the fields `redisConfig_5_0`, `redisConfig_6_0`, `redisConfig_6_2`, `redisConfig_7_0`
      "redisConfig_5_0": {
        "effectiveConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          }
        },
        "userConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          }
        },
        "defaultConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          }
        }
      },
      "redisConfig_6_0": {
        "effectiveConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          }
        },
        "userConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          }
        },
        "defaultConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          }
        }
      },
      "redisConfig_6_2": {
        "effectiveConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "maxmemoryPercent": "google.protobuf.Int64Value"
        },
        "userConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "maxmemoryPercent": "google.protobuf.Int64Value"
        },
        "defaultConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "maxmemoryPercent": "google.protobuf.Int64Value"
        }
      },
      "redisConfig_7_0": {
        "effectiveConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "maxmemoryPercent": "google.protobuf.Int64Value"
        },
        "userConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "maxmemoryPercent": "google.protobuf.Int64Value"
        },
        "defaultConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "maxmemoryPercent": "google.protobuf.Int64Value"
        }
      },
      // end of the list of possible fields
      "resources": {
        "resourcePresetId": "string",
        "diskSize": "int64",
        "diskTypeId": "string"
      },
      "backupWindowStart": "google.type.TimeOfDay",
      "access": {
        "dataLens": "bool",
        "webSql": "bool"
      },
      "redis": {
        "effectiveConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "maxmemoryPercent": "google.protobuf.Int64Value",
          "luaTimeLimit": "google.protobuf.Int64Value",
          "replBacklogSizePercent": "google.protobuf.Int64Value",
          "clusterRequireFullCoverage": "google.protobuf.BoolValue",
          "clusterAllowReadsWhenDown": "google.protobuf.BoolValue",
          "clusterAllowPubsubshardWhenDown": "google.protobuf.BoolValue",
          "lfuDecayTime": "google.protobuf.Int64Value",
          "lfuLogFactor": "google.protobuf.Int64Value",
          "turnBeforeSwitchover": "google.protobuf.BoolValue",
          "allowDataLoss": "google.protobuf.BoolValue"
        },
        "userConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "maxmemoryPercent": "google.protobuf.Int64Value",
          "luaTimeLimit": "google.protobuf.Int64Value",
          "replBacklogSizePercent": "google.protobuf.Int64Value",
          "clusterRequireFullCoverage": "google.protobuf.BoolValue",
          "clusterAllowReadsWhenDown": "google.protobuf.BoolValue",
          "clusterAllowPubsubshardWhenDown": "google.protobuf.BoolValue",
          "lfuDecayTime": "google.protobuf.Int64Value",
          "lfuLogFactor": "google.protobuf.Int64Value",
          "turnBeforeSwitchover": "google.protobuf.BoolValue",
          "allowDataLoss": "google.protobuf.BoolValue"
        },
        "defaultConfig": {
          "maxmemoryPolicy": "MaxmemoryPolicy",
          "timeout": "google.protobuf.Int64Value",
          "password": "string",
          "databases": "google.protobuf.Int64Value",
          "slowlogLogSlowerThan": "google.protobuf.Int64Value",
          "slowlogMaxLen": "google.protobuf.Int64Value",
          "notifyKeyspaceEvents": "string",
          "clientOutputBufferLimitPubsub": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "clientOutputBufferLimitNormal": {
            "hardLimit": "google.protobuf.Int64Value",
            "softLimit": "google.protobuf.Int64Value",
            "softSeconds": "google.protobuf.Int64Value"
          },
          "maxmemoryPercent": "google.protobuf.Int64Value",
          "luaTimeLimit": "google.protobuf.Int64Value",
          "replBacklogSizePercent": "google.protobuf.Int64Value",
          "clusterRequireFullCoverage": "google.protobuf.BoolValue",
          "clusterAllowReadsWhenDown": "google.protobuf.BoolValue",
          "clusterAllowPubsubshardWhenDown": "google.protobuf.BoolValue",
          "lfuDecayTime": "google.protobuf.Int64Value",
          "lfuLogFactor": "google.protobuf.Int64Value",
          "turnBeforeSwitchover": "google.protobuf.BoolValue",
          "allowDataLoss": "google.protobuf.BoolValue"
        }
      },
      "diskSizeAutoscaling": {
        "plannedUsageThreshold": "google.protobuf.Int64Value",
        "emergencyUsageThreshold": "google.protobuf.Int64Value",
        "diskSizeLimit": "google.protobuf.Int64Value"
      }
    },
    "networkId": "string",
    "health": "Health",
    "status": "Status",
    "sharded": "bool",
    "maintenanceWindow": {
      // Includes only one of the fields `anytime`, `weeklyMaintenanceWindow`
      "anytime": "AnytimeMaintenanceWindow",
      "weeklyMaintenanceWindow": {
        "day": "WeekDay",
        "hour": "int64"
      }
      // end of the list of possible fields
    },
    "plannedOperation": {
      "info": "string",
      "delayedUntil": "google.protobuf.Timestamp"
    },
    "securityGroupIds": [
      "string"
    ],
    "tlsEnabled": "bool",
    "deletionProtection": "bool",
    "persistenceMode": "PersistenceMode",
    "announceHostnames": "bool"
  }
  // end of the list of possible fields
}

An Operation resource. For more information, see Operation.

Field	Description
id	string ID of the operation.
description	string Description of the operation. 0-256 characters long.
createdAt	google.protobuf.Timestamp Creation timestamp.
createdBy	string ID of the user or service account who initiated the operation.
modifiedAt	google.protobuf.Timestamp The time when the Operation resource was last modified.
done	bool If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
metadata	StartClusterFailoverMetadata Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
error	google.rpc.Status The error result of the operation in case of failure or cancellation. Includes only one of the fields `error`, `response`. The operation result. If `done == false` and there was no failure detected, neither `error` nor `response` is set. If `done == false` and there was a failure detected, `error` is set. If `done == true`, exactly one of `error` or `response` is set.
response	Cluster The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is the standard Create/Update, the response should be the target resource of the operation. Any method that returns a long-running operation should document the response type, if any. Includes only one of the fields `error`, `response`. The operation result. If `done == false` and there was no failure detected, neither `error` nor `response` is set. If `done == false` and there was a failure detected, `error` is set. If `done == true`, exactly one of `error` or `response` is set.

StartClusterFailoverMetadata

Field

Description

clusterId

string

ID of the Redis cluster on which failover will be initiated.

hostNames[]

string

List of hostnames which should not be masters. Can be empty for sentinel clusters or can contain multiple hosts for sharded clusters.

Cluster

Description of a Redis cluster. For more information, see
the Managed Service for Redis documentation.

Field	Description
id	string ID of the Redis cluster. This ID is assigned by MDB at creation time.
folderId	string ID of the folder that the Redis cluster belongs to.
createdAt	google.protobuf.Timestamp Creation timestamp in RFC3339 text format.
name	string Name of the Redis cluster. The name is unique within the folder. 3-63 characters long.
description	string Description of the Redis cluster. 0-256 characters long.
labels	string Custom labels for the Redis cluster as `key:value` pairs. Maximum 64 per cluster.
environment	enum Environment Deployment environment of the Redis cluster. `ENVIRONMENT_UNSPECIFIED` `PRODUCTION`: Stable environment with a conservative update policy: only hotfixes are applied during regular maintenance. `PRESTABLE`: Environment with more aggressive update policy: new versions are rolled out irrespective of backward compatibility.
monitoring[]	Monitoring Description of monitoring systems relevant to the Redis cluster.
config	ClusterConfig Configuration of the Redis cluster.
networkId	string
health	enum Health Aggregated cluster health. `HEALTH_UNKNOWN`: Cluster is in unknown state (we have no data) `ALIVE`: Cluster is alive and well (all hosts are alive) `DEAD`: Cluster is inoperable (it cannot perform any of its essential functions) `DEGRADED`: Cluster is partially alive (it can perform some of its essential functions)
status	enum Status Cluster status. `STATUS_UNKNOWN`: Cluster status is unknown `CREATING`: Cluster is being created `RUNNING`: Cluster is running `ERROR`: Cluster failed `UPDATING`: Cluster is being updated. `STOPPING`: Cluster is stopping. `STOPPED`: Cluster stopped. `STARTING`: Cluster is starting.
sharded	bool Redis cluster mode on/off.
maintenanceWindow	MaintenanceWindow Maintenance window for the cluster.
plannedOperation	MaintenanceOperation Planned maintenance operation to be started for the cluster within the nearest `maintenanceWindow`.
securityGroupIds[]	string User security groups
tlsEnabled	bool TLS port and functionality on\off
deletionProtection	bool Deletion Protection inhibits deletion of the cluster
persistenceMode	enum PersistenceMode Persistence mode `ON`: cluster persistence mode on `OFF`: cluster persistence mode off
announceHostnames	bool Enable FQDN instead of ip

Monitoring

Field	Description
name	string Name of the monitoring system.
description	string Description of the monitoring system.
link	string Link to the monitoring system charts for the Redis cluster.

ClusterConfig

Field	Description
version	string Version of Redis server software.
redisConfig_5_0	RedisConfigSet5_0 Configuration of a Redis 5.0 server. Includes only one of the fields `redisConfig_5_0`, `redisConfig_6_0`, `redisConfig_6_2`, `redisConfig_7_0`. Configuration for Redis servers in the cluster.
redisConfig_6_0	RedisConfigSet6_0 Configuration of a Redis 6.0 server. Includes only one of the fields `redisConfig_5_0`, `redisConfig_6_0`, `redisConfig_6_2`, `redisConfig_7_0`. Configuration for Redis servers in the cluster.
redisConfig_6_2	RedisConfigSet6_2 Configuration of a Redis 6.2 server. Includes only one of the fields `redisConfig_5_0`, `redisConfig_6_0`, `redisConfig_6_2`, `redisConfig_7_0`. Configuration for Redis servers in the cluster.
redisConfig_7_0	RedisConfigSet7_0 Configuration of a Redis 7.0 server. Includes only one of the fields `redisConfig_5_0`, `redisConfig_6_0`, `redisConfig_6_2`, `redisConfig_7_0`. Configuration for Redis servers in the cluster.
resources	Resources Resources allocated to Redis hosts.
backupWindowStart	google.type.TimeOfDay Time to start the daily backup, in the UTC timezone.
access	Access Access policy to DB
redis	RedisConfigSet Unified configuration of a Redis cluster.
diskSizeAutoscaling	DiskSizeAutoscaling Disk size autoscaling settings

RedisConfigSet5_0

Field	Description
effectiveConfig	RedisConfig5_0 Effective settings for a Redis 5.0 cluster (a combination of settings defined in `userConfig` and `defaultConfig`).
userConfig	RedisConfig5_0 User-defined settings for a Redis 5.0 cluster.
defaultConfig	RedisConfig5_0 Default configuration for a Redis 5.0 cluster.

RedisConfig5_0

Fields and structure of RedisConfig reflects Redis configuration file
parameters.

Field	Description
maxmemoryPolicy	enum MaxmemoryPolicy Redis key eviction policy for a dataset that reaches maximum memory, available to the host. Redis maxmemory setting depends on Managed Service for Redis host class. All policies are described in detail in Redis documentation. `MAXMEMORY_POLICY_UNSPECIFIED` `VOLATILE_LRU`: Try to remove less recently used (LRU) keys with `expire set`. `ALLKEYS_LRU`: Remove less recently used (LRU) keys. `VOLATILE_LFU`: Try to remove least frequently used (LFU) keys with `expire set`. `ALLKEYS_LFU`: Remove least frequently used (LFU) keys. `VOLATILE_RANDOM`: Try to remove keys with `expire set` randomly. `ALLKEYS_RANDOM`: Remove keys randomly. `VOLATILE_TTL`: Try to remove less recently used (LRU) keys with `expire set` and shorter TTL first. `NOEVICTION`: Return errors when memory limit was reached and commands could require more memory to be used.
timeout	google.protobuf.Int64Value Time that Redis keeps the connection open while the client is idle. If no new command is sent during that time, the connection is closed.
password	string Authentication password.
databases	google.protobuf.Int64Value Number of database buckets on a single redis-server process.
slowlogLogSlowerThan	google.protobuf.Int64Value Threshold for logging slow requests to server in microseconds (log only slower than it).
slowlogMaxLen	google.protobuf.Int64Value Max slow requests number to log.
notifyKeyspaceEvents	string String setting for pub\sub functionality.
clientOutputBufferLimitPubsub	ClientOutputBufferLimit Redis connection output buffers limits for pubsub operations.
clientOutputBufferLimitNormal	ClientOutputBufferLimit Redis connection output buffers limits for clients.

ClientOutputBufferLimit

Field	Description
hardLimit	google.protobuf.Int64Value Total limit in bytes.
softLimit	google.protobuf.Int64Value Limit in bytes during certain time period.
softSeconds	google.protobuf.Int64Value Seconds for soft limit.

RedisConfigSet6_0

Field	Description
effectiveConfig	RedisConfig6_0 Effective settings for a Redis 6.0 cluster (a combination of settings defined in `userConfig` and `defaultConfig`).
userConfig	RedisConfig6_0 User-defined settings for a Redis 6.0 cluster.
defaultConfig	RedisConfig6_0 Default configuration for a Redis 6.0 cluster.

RedisConfig6_0

Fields and structure of RedisConfig reflects Redis configuration file
parameters.

Field	Description
maxmemoryPolicy	enum MaxmemoryPolicy Redis key eviction policy for a dataset that reaches maximum memory, available to the host. Redis maxmemory setting depends on Managed Service for Redis host class. All policies are described in detail in Redis documentation. `MAXMEMORY_POLICY_UNSPECIFIED` `VOLATILE_LRU`: Try to remove less recently used (LRU) keys with `expire set`. `ALLKEYS_LRU`: Remove less recently used (LRU) keys. `VOLATILE_LFU`: Try to remove least frequently used (LFU) keys with `expire set`. `ALLKEYS_LFU`: Remove least frequently used (LFU) keys. `VOLATILE_RANDOM`: Try to remove keys with `expire set` randomly. `ALLKEYS_RANDOM`: Remove keys randomly. `VOLATILE_TTL`: Try to remove less recently used (LRU) keys with `expire set` and shorter TTL first. `NOEVICTION`: Return errors when memory limit was reached and commands could require more memory to be used.
timeout	google.protobuf.Int64Value Time that Redis keeps the connection open while the client is idle. If no new command is sent during that time, the connection is closed.
password	string Authentication password.
databases	google.protobuf.Int64Value Number of database buckets on a single redis-server process.
slowlogLogSlowerThan	google.protobuf.Int64Value Threshold for logging slow requests to server in microseconds (log only slower than it).
slowlogMaxLen	google.protobuf.Int64Value Max slow requests number to log.
notifyKeyspaceEvents	string String setting for pub\sub functionality.
clientOutputBufferLimitPubsub	ClientOutputBufferLimit Redis connection output buffers limits for pubsub operations.
clientOutputBufferLimitNormal	ClientOutputBufferLimit Redis connection output buffers limits for clients.

ClientOutputBufferLimit

Field	Description
hardLimit	google.protobuf.Int64Value Total limit in bytes.
softLimit	google.protobuf.Int64Value Limit in bytes during certain time period.
softSeconds	google.protobuf.Int64Value Seconds for soft limit.

RedisConfigSet6_2

Field	Description
effectiveConfig	RedisConfig6_2 Effective settings for a Redis 6.2 cluster (a combination of settings defined in `userConfig` and `defaultConfig`).
userConfig	RedisConfig6_2 User-defined settings for a Redis 6.2 cluster.
defaultConfig	RedisConfig6_2 Default configuration for a Redis 6.2 cluster.

RedisConfig6_2

Fields and structure of RedisConfig reflects Redis configuration file
parameters.

Field	Description
maxmemoryPolicy	enum MaxmemoryPolicy Redis key eviction policy for a dataset that reaches maximum memory, available to the host. Redis maxmemory setting depends on Managed Service for Redis host class. All policies are described in detail in Redis documentation. `MAXMEMORY_POLICY_UNSPECIFIED` `VOLATILE_LRU`: Try to remove less recently used (LRU) keys with `expire set`. `ALLKEYS_LRU`: Remove less recently used (LRU) keys. `VOLATILE_LFU`: Try to remove least frequently used (LFU) keys with `expire set`. `ALLKEYS_LFU`: Remove least frequently used (LFU) keys. `VOLATILE_RANDOM`: Try to remove keys with `expire set` randomly. `ALLKEYS_RANDOM`: Remove keys randomly. `VOLATILE_TTL`: Try to remove less recently used (LRU) keys with `expire set` and shorter TTL first. `NOEVICTION`: Return errors when memory limit was reached and commands could require more memory to be used.
timeout	google.protobuf.Int64Value Time that Redis keeps the connection open while the client is idle. If no new command is sent during that time, the connection is closed.
password	string Authentication password.
databases	google.protobuf.Int64Value Number of database buckets on a single redis-server process.
slowlogLogSlowerThan	google.protobuf.Int64Value Threshold for logging slow requests to server in microseconds (log only slower than it).
slowlogMaxLen	google.protobuf.Int64Value Max slow requests number to log.
notifyKeyspaceEvents	string String setting for pub\sub functionality.
clientOutputBufferLimitPubsub	ClientOutputBufferLimit Redis connection output buffers limits for pubsub operations.
clientOutputBufferLimitNormal	ClientOutputBufferLimit Redis connection output buffers limits for clients.
maxmemoryPercent	google.protobuf.Int64Value Redis maxmemory percent

ClientOutputBufferLimit

Field	Description
hardLimit	google.protobuf.Int64Value Total limit in bytes.
softLimit	google.protobuf.Int64Value Limit in bytes during certain time period.
softSeconds	google.protobuf.Int64Value Seconds for soft limit.

RedisConfigSet7_0

Field	Description
effectiveConfig	RedisConfig7_0 Effective settings for a Redis 7.0 cluster (a combination of settings defined in `userConfig` and `defaultConfig`).
userConfig	RedisConfig7_0 User-defined settings for a Redis 7.0 cluster.
defaultConfig	RedisConfig7_0 Default configuration for a Redis 7.0 cluster.

RedisConfig7_0

Fields and structure of RedisConfig reflects Redis configuration file
parameters.

Field	Description
maxmemoryPolicy	enum MaxmemoryPolicy Redis key eviction policy for a dataset that reaches maximum memory, available to the host. Redis maxmemory setting depends on Managed Service for Redis host class. All policies are described in detail in Redis documentation. `MAXMEMORY_POLICY_UNSPECIFIED` `VOLATILE_LRU`: Try to remove less recently used (LRU) keys with `expire set`. `ALLKEYS_LRU`: Remove less recently used (LRU) keys. `VOLATILE_LFU`: Try to remove least frequently used (LFU) keys with `expire set`. `ALLKEYS_LFU`: Remove least frequently used (LFU) keys. `VOLATILE_RANDOM`: Try to remove keys with `expire set` randomly. `ALLKEYS_RANDOM`: Remove keys randomly. `VOLATILE_TTL`: Try to remove less recently used (LRU) keys with `expire set` and shorter TTL first. `NOEVICTION`: Return errors when memory limit was reached and commands could require more memory to be used.
timeout	google.protobuf.Int64Value Time that Redis keeps the connection open while the client is idle. If no new command is sent during that time, the connection is closed.
password	string Authentication password.
databases	google.protobuf.Int64Value Number of database buckets on a single redis-server process.
slowlogLogSlowerThan	google.protobuf.Int64Value Threshold for logging slow requests to server in microseconds (log only slower than it).
slowlogMaxLen	google.protobuf.Int64Value Max slow requests number to log.
notifyKeyspaceEvents	string String setting for pub\sub functionality.
clientOutputBufferLimitPubsub	ClientOutputBufferLimit Redis connection output buffers limits for pubsub operations.
clientOutputBufferLimitNormal	ClientOutputBufferLimit Redis connection output buffers limits for clients.
maxmemoryPercent	google.protobuf.Int64Value Redis maxmemory percent

ClientOutputBufferLimit

Field	Description
hardLimit	google.protobuf.Int64Value Total limit in bytes.
softLimit	google.protobuf.Int64Value Limit in bytes during certain time period.
softSeconds	google.protobuf.Int64Value Seconds for soft limit.

Resources

Field	Description
resourcePresetId	string ID of the preset for computational resources available to a host (CPU, memory etc.). All available presets are listed in the documentation.
diskSize	int64 Volume of the storage available to a host, in bytes.
diskTypeId	string Type of the storage environment for the host. Possible values: network-ssd - network SSD drive, local-ssd - local SSD storage.

Access

Field

Description

dataLens

bool

Allow access for DataLens

webSql

bool

Allow access for Web SQL.

RedisConfigSet

Field	Description
effectiveConfig	RedisConfig Effective settings for a Redis cluster (a combination of settings defined in `userConfig` and `defaultConfig`).
userConfig	RedisConfig User-defined settings for a Redis cluster.
defaultConfig	RedisConfig Default configuration for a Redis cluster.

RedisConfig

Fields and structure of RedisConfig reflects Redis configuration file
parameters.

Field	Description
maxmemoryPolicy	enum MaxmemoryPolicy Redis key eviction policy for a dataset that reaches maximum memory, available to the host. Redis maxmemory setting depends on Managed Service for Redis host class. All policies are described in detail in Redis documentation. `MAXMEMORY_POLICY_UNSPECIFIED` `VOLATILE_LRU`: Try to remove less recently used (LRU) keys with `expire set`. `ALLKEYS_LRU`: Remove less recently used (LRU) keys. `VOLATILE_LFU`: Try to remove least frequently used (LFU) keys with `expire set`. `ALLKEYS_LFU`: Remove least frequently used (LFU) keys. `VOLATILE_RANDOM`: Try to remove keys with `expire set` randomly. `ALLKEYS_RANDOM`: Remove keys randomly. `VOLATILE_TTL`: Try to remove less recently used (LRU) keys with `expire set` and shorter TTL first. `NOEVICTION`: Return errors when memory limit was reached and commands could require more memory to be used.
timeout	google.protobuf.Int64Value Time that Redis keeps the connection open while the client is idle. If no new command is sent during that time, the connection is closed.
password	string Authentication password.
databases	google.protobuf.Int64Value Number of database buckets on a single redis-server process.
slowlogLogSlowerThan	google.protobuf.Int64Value Threshold for logging slow requests to server in microseconds (log only slower than it).
slowlogMaxLen	google.protobuf.Int64Value Max slow requests number to log.
notifyKeyspaceEvents	string String setting for pub\sub functionality.
clientOutputBufferLimitPubsub	ClientOutputBufferLimit Redis connection output buffers limits for pubsub operations.
clientOutputBufferLimitNormal	ClientOutputBufferLimit Redis connection output buffers limits for clients.
maxmemoryPercent	google.protobuf.Int64Value Redis maxmemory percent
luaTimeLimit	google.protobuf.Int64Value Maximum time in milliseconds for Lua scripts, 0 - disabled mechanism
replBacklogSizePercent	google.protobuf.Int64Value Replication backlog size as a percentage of flavor maxmemory
clusterRequireFullCoverage	google.protobuf.BoolValue Controls whether all hash slots must be covered by nodes
clusterAllowReadsWhenDown	google.protobuf.BoolValue Allows read operations when cluster is down
clusterAllowPubsubshardWhenDown	google.protobuf.BoolValue Permits Pub/Sub shard operations when cluster is down
lfuDecayTime	google.protobuf.Int64Value The time, in minutes, that must elapse in order for the key counter to be divided by two (or decremented if it has a value less <= 10)
lfuLogFactor	google.protobuf.Int64Value Determines how the frequency counter represents key hits.
turnBeforeSwitchover	google.protobuf.BoolValue Allows to turn before switchover in RDSync
allowDataLoss	google.protobuf.BoolValue Allows some data to be lost in favor of faster switchover/restart

ClientOutputBufferLimit

Field	Description
hardLimit	google.protobuf.Int64Value Total limit in bytes.
softLimit	google.protobuf.Int64Value Limit in bytes during certain time period.
softSeconds	google.protobuf.Int64Value Seconds for soft limit.

DiskSizeAutoscaling

Field	Description
plannedUsageThreshold	google.protobuf.Int64Value Amount of used storage for automatic disk scaling in the maintenance window, 0 means disabled, in percent.
emergencyUsageThreshold	google.protobuf.Int64Value Amount of used storage for immediately automatic disk scaling, 0 means disabled, in percent.
diskSizeLimit	google.protobuf.Int64Value Limit on how large the storage for database instances can automatically grow, in bytes.

MaintenanceWindow

A maintenance window settings.

Field

Description

anytime

AnytimeMaintenanceWindow

Maintenance operation can be scheduled anytime.

Includes only one of the fields anytime, weeklyMaintenanceWindow.

The maintenance policy in effect.

weeklyMaintenanceWindow

WeeklyMaintenanceWindow

Maintenance operation can be scheduled on a weekly basis.

Includes only one of the fields anytime, weeklyMaintenanceWindow.

The maintenance policy in effect.

AnytimeMaintenanceWindow

Field	Description
Empty

WeeklyMaintenanceWindow

Weelky maintenance window settings.

Field

Description

day

enum WeekDay

Day of the week (in DDD format).

WEEK_DAY_UNSPECIFIED
MON
TUE
WED
THU
FRI
SAT
SUN

hour

int64

Hour of the day in UTC (in HH format).

MaintenanceOperation

A planned maintenance operation.

Field

Description

info

string

Information about this maintenance operation.

delayedUntil

google.protobuf.Timestamp

Time until which this maintenance operation is delayed.

Managed Service for Redis API, gRPC: ClusterService.StartFailover

gRPC requestgRPC request

StartClusterFailoverRequestStartClusterFailoverRequest

operation.Operationoperation.Operation

StartClusterFailoverMetadataStartClusterFailoverMetadata

ClusterCluster

MonitoringMonitoring

ClusterConfigClusterConfig

RedisConfigSet5_0RedisConfigSet5_0

RedisConfig5_0RedisConfig5_0

ClientOutputBufferLimitClientOutputBufferLimit

RedisConfigSet6_0RedisConfigSet6_0

RedisConfig6_0RedisConfig6_0

ClientOutputBufferLimitClientOutputBufferLimit

RedisConfigSet6_2RedisConfigSet6_2

RedisConfig6_2RedisConfig6_2

ClientOutputBufferLimitClientOutputBufferLimit

RedisConfigSet7_0RedisConfigSet7_0

RedisConfig7_0RedisConfig7_0

ClientOutputBufferLimitClientOutputBufferLimit

ResourcesResources

AccessAccess

RedisConfigSetRedisConfigSet

RedisConfigRedisConfig

ClientOutputBufferLimitClientOutputBufferLimit

DiskSizeAutoscalingDiskSizeAutoscaling

MaintenanceWindowMaintenanceWindow

AnytimeMaintenanceWindowAnytimeMaintenanceWindow

WeeklyMaintenanceWindowWeeklyMaintenanceWindow

MaintenanceOperationMaintenanceOperation

Was the article helpful?

gRPC request

StartClusterFailoverRequest

operation.Operation

StartClusterFailoverMetadata

Cluster

Monitoring

ClusterConfig

RedisConfigSet5_0

RedisConfig5_0

ClientOutputBufferLimit

RedisConfigSet6_0

RedisConfig6_0

ClientOutputBufferLimit

RedisConfigSet6_2

RedisConfig6_2

ClientOutputBufferLimit

RedisConfigSet7_0

RedisConfig7_0

ClientOutputBufferLimit

Resources

Access

RedisConfigSet

RedisConfig

ClientOutputBufferLimit

DiskSizeAutoscaling

MaintenanceWindow

AnytimeMaintenanceWindow

WeeklyMaintenanceWindow

MaintenanceOperation