Get started
Yandex Managed Service for Redis

Cluster

A set of methods for managing Redis clusters.

JSON Representation

{
  "id": "string",
  "folderId": "string",
  "createdAt": "string",
  "name": "string",
  "description": "string",
  "labels": "object",
  "environment": "string",
  "monitoring": [
    {
      "name": "string",
      "description": "string",
      "link": "string"
    }
  ],
  "config": {
    "version": "string",
    "resources": {
      "resourcePresetId": "string",
      "diskSize": "string"
    },
    "backupWindowStart": {
      "hours": "integer",
      "minutes": "integer",
      "seconds": "integer",
      "nanos": "integer"
    },
    "access": {
      "dataLens": true
    },

    // `config` includes only one of the fields `redisConfig_5_0`, `redisConfig_6_0`
    "redisConfig_5_0": {
      "effectiveConfig": {
        "maxmemoryPolicy": "string",
        "timeout": "integer",
        "password": "string"
      },
      "userConfig": {
        "maxmemoryPolicy": "string",
        "timeout": "integer",
        "password": "string"
      },
      "defaultConfig": {
        "maxmemoryPolicy": "string",
        "timeout": "integer",
        "password": "string"
      }
    },
    "redisConfig_6_0": {
      "effectiveConfig": {
        "maxmemoryPolicy": "string",
        "timeout": "integer",
        "password": "string"
      },
      "userConfig": {
        "maxmemoryPolicy": "string",
        "timeout": "integer",
        "password": "string"
      },
      "defaultConfig": {
        "maxmemoryPolicy": "string",
        "timeout": "integer",
        "password": "string"
      }
    },
    // end of the list of possible fields`config`

  },
  "networkId": "string",
  "health": "string",
  "status": "string",
  "sharded": true,
  "maintenanceWindow": {

    // `maintenanceWindow` includes only one of the fields `anytime`, `weeklyMaintenanceWindow`
    "anytime": {},
    "weeklyMaintenanceWindow": {
      "day": "string",
      "hour": "string"
    },
    // end of the list of possible fields`maintenanceWindow`

  },
  "plannedOperation": {
    "info": "string",
    "delayedUntil": "string"
  },
  "securityGroupIds": [
    "string"
  ]
}
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 string (date-time)

Creation timestamp in RFC3339 text format.

String 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 object

Custom labels for the Redis cluster as key:value pairs. Maximum 64 per cluster.
environment string

Deployment environment of the Redis cluster.

  • 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[] object

Description of monitoring systems relevant to the Redis cluster.
monitoring[].
name		 string

Name of the monitoring system.
monitoring[].
description		 string

Description of the monitoring system.
monitoring[].
link		 string

Link to the monitoring system charts for the Redis cluster.
config object

Configuration of the Redis cluster.
config.
version		 string

Version of Redis server software.
config.
resources		 object
config.
resources.
resourcePresetId		 string

ID of the preset for computational resources available to a host (CPU, memory etc.). All available presets are listed in the documentation.
config.
resources.
diskSize		 string (int64)

Volume of the storage available to a host, in bytes.
config.
backupWindowStart		 object

Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and google.protobuf.Timestamp.
config.
backupWindowStart.
hours		 integer (int32)

Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
config.
backupWindowStart.
minutes		 integer (int32)

Minutes of hour of day. Must be from 0 to 59.
config.
backupWindowStart.
seconds		 integer (int32)

Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
config.
backupWindowStart.
nanos		 integer (int32)

Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
config.
access		 object
config.
access.
dataLens		 boolean (boolean)

Allow access for DataLens
config.
redisConfig_5_0		 object
config includes only one of the fields redisConfig_5_0, redisConfig_6_0
config.
redisConfig_5_0.
effectiveConfig		 object

Effective settings for a Redis 5.0 cluster (a combination of settings defined in userConfig and defaultConfig).

Fields and structure of RedisConfig reflects Redis configuration file parameters.
config.
redisConfig_5_0.
effectiveConfig.
maxmemoryPolicy		 string

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.

  • 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.
config.
redisConfig_5_0.
effectiveConfig.
timeout		 integer (int64)

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.
config.
redisConfig_5_0.
effectiveConfig.
password		 string

Authentication password.

Value must match the regular expression [a-zA-Z0-9@=+?*.,!&#$^<>_-]{8,128}.
config.
redisConfig_5_0.
userConfig		 object

User-defined settings for a Redis 5.0 cluster.

Fields and structure of RedisConfig reflects Redis configuration file parameters.
config.
redisConfig_5_0.
userConfig.
maxmemoryPolicy		 string

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.

  • 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.
config.
redisConfig_5_0.
userConfig.
timeout		 integer (int64)

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.
config.
redisConfig_5_0.
userConfig.
password		 string

Authentication password.

Value must match the regular expression [a-zA-Z0-9@=+?*.,!&#$^<>_-]{8,128}.
config.
redisConfig_5_0.
defaultConfig		 object

Default configuration for a Redis 5.0 cluster.

Fields and structure of RedisConfig reflects Redis configuration file parameters.
config.
redisConfig_5_0.
defaultConfig.
maxmemoryPolicy		 string

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.

  • 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.
config.
redisConfig_5_0.
defaultConfig.
timeout		 integer (int64)

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.
config.
redisConfig_5_0.
defaultConfig.
password		 string

Authentication password.

Value must match the regular expression [a-zA-Z0-9@=+?*.,!&#$^<>_-]{8,128}.
config.
redisConfig_6_0		 object
config includes only one of the fields redisConfig_5_0, redisConfig_6_0
config.
redisConfig_6_0.
effectiveConfig		 object

Effective settings for a Redis 6.0 cluster (a combination of settings defined in userConfig and defaultConfig).

Fields and structure of RedisConfig reflects Redis configuration file parameters.
config.
redisConfig_6_0.
effectiveConfig.
maxmemoryPolicy		 string

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.

  • 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.
config.
redisConfig_6_0.
effectiveConfig.
timeout		 integer (int64)

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.
config.
redisConfig_6_0.
effectiveConfig.
password		 string

Authentication password.

Value must match the regular expression [a-zA-Z0-9@=+?*.,!&#$^<>_-]{8,128}.
config.
redisConfig_6_0.
userConfig		 object

User-defined settings for a Redis 6.0 cluster.

Fields and structure of RedisConfig reflects Redis configuration file parameters.
config.
redisConfig_6_0.
userConfig.
maxmemoryPolicy		 string

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.

  • 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.
config.
redisConfig_6_0.
userConfig.
timeout		 integer (int64)

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.
config.
redisConfig_6_0.
userConfig.
password		 string

Authentication password.

Value must match the regular expression [a-zA-Z0-9@=+?*.,!&#$^<>_-]{8,128}.
config.
redisConfig_6_0.
defaultConfig		 object

Default configuration for a Redis 6.0 cluster.

Fields and structure of RedisConfig reflects Redis configuration file parameters.
config.
redisConfig_6_0.
defaultConfig.
maxmemoryPolicy		 string

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.

  • 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.
config.
redisConfig_6_0.
defaultConfig.
timeout		 integer (int64)

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.
config.
redisConfig_6_0.
defaultConfig.
password		 string

Authentication password.

Value must match the regular expression [a-zA-Z0-9@=+?*.,!&#$^<>_-]{8,128}.
networkId string
health string

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 string

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 boolean (boolean)

Redis cluster mode on/off.
maintenanceWindow object

Window of maintenance operations.
maintenanceWindow.
anytime		 object
maintenanceWindow includes only one of the fields anytime, weeklyMaintenanceWindow
maintenanceWindow.
weeklyMaintenanceWindow		 object
maintenanceWindow includes only one of the fields anytime, weeklyMaintenanceWindow
maintenanceWindow.
weeklyMaintenanceWindow.
day		 string
maintenanceWindow.
weeklyMaintenanceWindow.
hour		 string (int64)

Hour of the day in UTC.

Acceptable values are 1 to 24, inclusive.
plannedOperation object

Maintenance operation planned at nearest maintenance_window.
plannedOperation.
info		 string

The maximum string length in characters is 256.
plannedOperation.
delayedUntil		 string (date-time)

String in RFC3339 text format.
securityGroupIds[] string

User security groups

Methods

Method Description
addHosts Creates new hosts for a cluster.
addShard Creates a new shard.
backup Creates a backup for the specified Redis cluster.
create Creates a Redis cluster in the specified folder.
delete Deletes the specified Redis cluster.
deleteHosts Deletes the specified hosts for a cluster.
deleteShard Deletes the specified shard.
get Returns the specified Redis cluster.
getShard Returns the specified shard.
list Retrieves the list of Redis clusters that belong to the specified folder.
listBackups Retrieves the list of available backups for the specified Redis cluster.
listHosts Retrieves a list of hosts for the specified cluster.
listLogs Retrieves logs for the specified Redis cluster.
listOperations Retrieves the list of operations for the specified cluster.
listShards Retrieves a list of shards.
move Moves a Redis cluster to the specified folder.
rebalance Rebalances the cluster. Evenly distributes all the hash slots between the shards.
rescheduleMaintenance Reschedule planned maintenance operation.
restore Creates a new Redis cluster using the specified backup.
start Start the specified Redis cluster.
startFailover Start a manual failover on the specified Redis cluster.
stop Stop the specified Redis cluster.
streamLogs Same as ListLogs but using server-side streaming. Also allows for 'tail -f' semantics.
update Updates the specified Redis cluster.
In this article: