An API object that represents a managed database in the cluster.

NameType/ValueDescription
uidintegerCluster unique ID of database. Can be set during creation but cannot be updated.
account_idintegerSM account ID
action_uidstringCurrently running action’s UID (read-only)
aof_policy‘appendfsync-every-sec’
‘appendfsync-always’		Policy for Append-Only File data persistence
authentication_admin_passstringPassword for administrative access to the BDB (used for SYNC from the BDB)
authentication_redis_passstringRedis AUTH password authentication.
Use for Redis databases only. Ignored for memcached databases. (deprecated as of Redis Enterprise v7.2, replaced with multiple passwords feature in version 6.0.X)
authentication_sasl_passstringBinary memcache SASL password
authentication_sasl_unamestringBinary memcache SASL username (pattern does not allow special characters &,<,>,")
authentication_ssl_client_certs
	
[{
  "client_cert": string
}, ...]
List of authorized client certificates
client_cert: X.509 PEM (base64) encoded certificate
authentication_ssl_crdt_certs

[{
  "client_cert": string
}, ...]
List of authorized CRDT certificates
client_cert: X.509 PEM (base64) encoded certificate
authorized_namesarray of stringsAdditional certified names (deprecated as of Redis Enterprise v6.4.2; use authorized_subjects instead)
authorized_subjects

[{
  "CN": string,
  "O": string,
  "OU": [array of strings],
  "L": string,
  "ST": string,
  "C": string
}, ...]
A list of valid subjects used for additional certificate validations during TLS client authentication. All subject attributes are case-sensitive.
Required subject fields:
“CN” for Common Name
Optional subject fields:
“O” for Organization
“OU” for Organizational Unit (array of strings)
“L” for Locality (city)
“ST” for State/Province
“C” for 2-letter country code
avoid_nodesarray of stringsCluster node UIDs to avoid when placing the database’s shards and binding its endpoints
background_op

[{
  "status": string,
  "name": string,
  "error": object,
  "progress": number
}, ...]
(read-only); progress: Percent of completed steps in current operation
backupboolean (default: false)Policy for periodic database backup
backup_failure_reason’no-permission’
‘wrong-file-path’
‘general-error’		Reason of last failed backup process (read-only)
backup_historyinteger (default: 0)Backup history retention policy (number of days, 0 is forever)
backup_intervalintegerInterval in seconds in which automatic backup will be initiated
backup_interval_offsetintegerOffset (in seconds) from round backup interval when automatic backup will be initiated (should be less than backup_interval)
backup_locationcomplex objectTarget for automatic database backups.
Call GET /jsonschema to retrieve the object’s structure.
backup_progressnumber, (range: 0-100)Database scheduled periodic backup progress (percentage) (read-only)
backup_status’exporting’
‘succeeded’
‘failed’		Status of scheduled periodic backup process (read-only)
bigstoreboolean (default: false)Database bigstore option
bigstore_ram_sizeinteger (default: 0)Memory size of bigstore RAM part.
bigstore_ram_weights
	
[{
  "shard_uid": integer,
  "weight": number
}, ...]
List of shard UIDs and their bigstore RAM weights;
shard_uid: Shard UID;
weight: Relative weight of RAM distribution
client_cert_subject_validation_typedisabled
san_cn
full_subject		Enables additional certificate validations that further limit connections to clients with valid certificates during TLS client authentication.
disabled: Authenticates clients with valid certificates. No additional validations are enforced.
san_cn: A client certificate is valid only if its Common Name (CN) matches an entry in the list of valid subjects. Ignores other Subject attributes.
full_subject: A client certificate is valid only if its Subject attributes match an entry in the list of valid subjects.
crdtboolean (default: false)Use CRDT-based data types for multi-master replication
crdt_causal_consistencyboolean (default: false)Causal consistent CRDB.
crdt_config_versionintegerReplica-set configuration version, for internal use only.
crdt_featureset_versionintegerCRDB active FeatureSet version
crdt_ghost_replica_idsstringRemoved replicas IDs, for internal use only.
crdt_guidstringGUID of CRDB this database belongs to, for internal use only.
crdt_protocol_versionintegerCRDB active Protocol version
crdt_repl_backlog_sizestringActive-Active replication backlog size (‘auto’ or size in bytes)
crdt_replica_idintegerLocal replica ID, for internal use only.
crdt_replicasstringReplica set configuration, for internal use only.
crdt_sourcesarray of syncer_sources objectsRemote endpoints/peers of CRDB database to sync from. See the ‘bdb -> replica_sources’ section
crdt_sync’enabled’
‘disabled’
‘paused’
‘stopped’		Enable, disable, or pause syncing from specified crdt_sources. Applicable only for Active-Active databases. See replica_sync for more details.
crdt_sync_distbooleanEnable/disable distributed syncer in master-master
crdt_syncer_auto_oom_unlatchboolean (default: true)Syncer automatically attempts to recover synchronisation from peers after this database throws an Out-Of-Memory error. Otherwise, the syncer exits
created_timestringThe date and time the database was created (read-only)
data_internode_encryptionbooleanShould the data plane internode communication for this database be encrypted
data_persistence‘disabled’
‘snapshot’
‘aof’		Database on-disk persistence policy. For snapshot persistence, a snapshot_policy must be provided
dataset_import_sourcescomplex objectArray of source file location description objects to import from when performing an import action. This is write-only and cannot be read after set.
Call GET /jsonschema to retrieve the object’s structure.
db_conns_auditingbooleanEnables/deactivates database connection auditing
default_userboolean (default: true)Allow/disallow a default user to connect
disabled_commandsstring (default: )Redis commands which are disabled in db
dns_address_masterstringDatabase private address endpoint FQDN (read-only) (deprecated as of Redis Enterprise v4.3.3)
email_alertsboolean (default: false)Send email alerts for this DB
endpointstringLatest bound endpoint. Used when reconfiguring an endpoint via update
endpoint_ipcomplex objectExternal IP addresses of node hosting the BDB’s endpoint. GET /jsonschema to retrieve the object’s structure. (read-only) (deprecated as of Redis Enterprise v4.3.3)
endpoint_nodeintegerNode UID hosting the BDB’s endpoint (read-only) (deprecated as of Redis Enterprise v4.3.3)
endpointsarrayList of database access endpoints (read-only)
enforce_client_authentication’enabled’
‘disabled’		Require authentication of client certificates for SSL connections to the database. If set to ’enabled’, a certificate should be provided in either authentication_ssl_client_certs or authentication_ssl_crdt_certs
eviction_policy‘volatile-lru’
‘volatile-ttl’
‘volatile-random’
‘allkeys-lru’
‘allkeys-random’
‘noeviction’
‘volatile-lfu’
‘allkeys-lfu’		Database eviction policy (Redis style).
Redis DB default: ‘volatile-lru’
memcached DB default: ‘allkeys-lru’
export_failure_reason’no-permission’
‘wrong-file-path’
‘general-error’		Reason of last failed export process (read-only)
export_progressnumber, (range: 0-100)Database manually triggered export progress (percentage) (read-only)
export_status’exporting’
‘succeeded’
‘failed’		Status of manually triggered export process (read-only)
generate_text_monitorbooleanEnable/disable generation of syncer monitoring information
gradual_src_max_sourcesinteger (default: 1)Sync a maximum N sources in parallel (gradual_src_mode should be enabled for this to take effect)
gradual_src_mode’enabled’
‘disabled’		Indicates if gradual sync (of sync sources) should be activated
gradual_sync_max_shards_per_sourceinteger (default: 1)Sync a maximum of N shards per source in parallel (gradual_sync_mode should be enabled for this to take effect)
gradual_sync_mode’enabled’
‘disabled’
‘auto’		Indicates if gradual sync (of source shards) should be activated (‘auto’ for automatic decision)
hash_slots_policy’legacy’
‘16k’		The policy used for hash slots handling
’legacy’: slots range is ‘1-4096’
‘16k’: slots range is ‘0-16383’
implicit_shard_keyboolean (default: false)Controls the behavior of what happens in case a key does not match any of the regex rules.
true: if a key does not match any of the rules, the entire key will be used for the hashing function
false: if a key does not match any of the rules, an error will be returned.
import_failure_reason‘download-error’
‘file-corrupted’
‘general-error’
‘file-larger-than-mem-limit:<n bytes of expected dataset>:<n bytes configured bdb limit>’
‘key-too-long’
‘invalid-bulk-length’
‘out-of-memory’		Import failure reason (read-only)
import_progressnumber, (range: 0-100)Database import progress (percentage) (read-only)
import_status‘idle’
‘initializing’
‘importing’
‘succeeded’
‘failed’		Database import process status (read-only)
internalboolean (default: false)Is this a database used by the cluster internally
last_backup_timestringTime of last successful backup (read-only)
last_changed_timestringLast administrative configuration change (read-only)
last_export_timestringTime of last successful export (read-only)
max_aof_file_sizeintegerMaximum size for shard’s AOF file (bytes). Default 300GB, (on bigstore DB 150GB)
max_aof_load_timeinteger (default: 3600)Maximum time shard’s AOF reload should take (seconds).
max_connectionsinteger (default: 0)Maximum number of client connections allowed (0 unlimited)
memory_sizeinteger (default: 0)Database memory limit (0 is unlimited), expressed in bytes.
metrics_export_allbooleanEnable/disable exposing all shard metrics through the metrics exporter
mkmsboolean (default: true)Are MKMS (Multi Key Multi Slots) commands supported?
module_list

[{
  "module_id": string,
  "module_args": [u'string', u'null'],
  "module_name": string,
  "semantic_version": string
}, ...]
List of modules associated with the database

module_id: Module UID
module_args: Module command-line arguments (pattern does not allow special characters &,<,>,")
module_name: Module’s name
semantic_version: Module’s semantic version

As of Redis Enterprise Software v7.4.2, module_id and semantic_version are optional.
mtls_allow_outdated_certsbooleanAn optional mTLS relaxation flag for certs verification
mtls_allow_weak_hashingbooleanAn optional mTLS relaxation flag for certs verification
namestringDatabase name. Only letters, numbers, or hyphens are valid characters. The name must start and end with a letter or number.
oss_clusterboolean (default: false)OSS Cluster mode option. Cannot be enabled with 'hash_slots_policy': 'legacy'
oss_cluster_api_preferred_ip_type‘internal’
‘external’		Internal/external IP type in OSS cluster API. Default value for new endpoints
oss_shardingboolean (default: false)An alternative to shard_key_regex for using the common case of the OSS shard hashing policy
portintegerTCP port on which the database is available. Generated automatically if omitted and returned as 0
proxy_policy‘single’
‘all-master-shards’
‘all-nodes’		The default policy used for proxy binding to endpoints
rack_awareboolean (default: false)Require the database to always replicate across multiple racks
recovery_wait_timeinteger (default: -1)Defines how many seconds to wait for the persistence file to become available during auto recovery. After the wait time expires, auto recovery completes with potential data loss. The default -1 means to wait forever.
redis_versionstringVersion of the redis-server processes: e.g. 6.0, 5.0-big
repl_backlog_sizestringRedis replication backlog size (‘auto’ or size in bytes)
replica_sourcesarray of syncer_sources objectsRemote endpoints of database to sync from. See the ‘bdb -> replica_sources’ section
replica_sync’enabled’
‘disabled’
‘paused’
‘stopped’		Enable, disable, or pause syncing from specified replica_sources
replica_sync_distbooleanEnable/disable distributed syncer in replica-of
replicationboolean (default: false)In-memory database replication mode
resp3boolean (default: true)Enables or deactivates RESP3 support
roles_permissions

[{
  "role_uid": integer,
  "redis_acl_uid": integer
}, ...]
shard_block_crossslot_keysboolean (default: false)In Lua scripts, prevent use of keys from different hash slots within the range owned by the current shard
shard_block_foreign_keysboolean (default: true)In Lua scripts, foreign_keys prevent use of keys which could reside in a different shard (foreign keys)
shard_key_regex

[{
  "regex": string
}, ...]


To use the default rules you should set the value to:

[
  { “regex”: “.*\\{(?< tag >.*)\\}.*” }, 
  { “regex”: “(?< tag >.*)” }
]
Custom keyname-based sharding rules.
shard_listarray of integersCluster unique IDs of all database shards.
shardingboolean (default: false)Cluster mode (server-side sharding). When true, shard hashing rules must be provided by either oss_sharding or shard_key_regex
shards_countinteger, (range: 1-512) (default: 1)Number of database server-side shards
shards_placement‘dense’
‘sparse’		Control the density of shards
‘dense’: Shards reside on as few nodes as possible
‘sparse’: Shards reside on as many nodes as possible
skip_import_analyze’enabled’
‘disabled’		Enable/disable skipping the analysis stage when importing an RDB file
slave_buffer‘auto’
value in MB
hard:soft:time		Redis replica output buffer limits
slave_habooleanEnable replica high availability mechanism for this database (default takes the cluster setting)
slave_ha_priorityintegerPriority of the BDB in replica high availability mechanism
snapshot_policyarray of snapshot_policy objectsPolicy for snapshot-based data persistence. A dataset snapshot will be taken every N secs if there are at least M writes changes in the dataset
sslboolean (default: false)Require SSL authenticated and encrypted connections to the database (deprecated as of Redis Enterprise v5.0.1)
status‘pending’
‘active’
‘active-change-pending’
‘delete-pending’
‘import-pending’
‘creation-failed’
‘recovery’		Database lifecycle status (read-only)
sync’enabled’
‘disabled’
‘paused’
‘stopped’		(deprecated as of Redis Enterprise v5.0.1, use replica_sync or crdt_sync instead) Enable, disable, or pause syncing from specified sync_sources
sync_sources

[{
  "uid": integer,
  "uri": string,
  "compression": integer,
  "status": string,
  "rdb_transferred": integer,
  "rdb_size": integer,
  "last_update": string,
  "lag": integer,
  "last_error": string
}, ...]
(deprecated as of Redis Enterprise v5.0.1, instead use replica_sources or crdt_sources) Remote endpoints of database to sync from. See the ‘bdb -> replica_sources’ section
uid: Numeric unique identification of this source
uri: Source Redis URI
compression: Compression level for the replication link
status: Sync status of this source
rdb_transferred: Number of bytes transferred from the source’s RDB during the syncing phase
rdb_size: The source’s RDB size to be transferred during the syncing phase
last_update: Time last update was received from the source
lag: Lag in millisec between source and destination (while synced)
last_error: Last error encountered when syncing from the source
syncer_mode‘distributed’
‘centralized’		The syncer for replication between database instances is either on a single node (centralized) or on each node that has a proxy according to the proxy policy (distributed). (read-only)
tags
	
[{
  "key": string,
  "value": string
}, ...]
Optional list of tags objects attached to the database
key: Represents the tag’s meaning and must be unique among tags (pattern does not allow special characters &,<,>,")
value: The tag’s value
tls_mode’enabled’
‘disabled’
‘replica_ssl’		Require TLS-authenticated and encrypted connections to the database
type‘redis’
‘memcached’		Type of database
use_nodesarray of stringsCluster node UIDs to use for database shards and bound endpoints
versionstringDatabase compatibility version: full Redis/memcached version number, such as 6.0.6. This value can only change during database creation and database upgrades.
wait_commandboolean (default: true)Supports Redis wait command (read-only)