Share via

Microsoft.Cache redisEnterprise/databases

Bicep resource definition

The redisEnterprise/databases resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Cache/redisEnterprise/databases resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.Cache/redisEnterprise/databases@2025-08-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    accessKeysAuthentication: 'string'
    clientProtocol: 'string'
    clusteringPolicy: 'string'
    deferUpgrade: 'string'
    evictionPolicy: 'string'
    geoReplication: {
      groupNickname: 'string'
      linkedDatabases: [
        {
          id: 'string'
        }
      ]
    }
    modules: [
      {
        args: 'string'
        name: 'string'
      }
    ]
    persistence: {
      aofEnabled: bool
      aofFrequency: 'string'
      rdbEnabled: bool
      rdbFrequency: 'string'
    }
    port: int
  }
}

Property Values

Microsoft.Cache/redisEnterprise/databases

Name Description Value
name The resource name string

Constraints:
Pattern = ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ (required)
parent In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource.

For more information, see Child resource outside parent resource.		 Symbolic name for resource of type: redisEnterprise
properties Other properties of the database. DatabaseCreateProperties

DatabaseCreateProperties

Name Description Value
accessKeysAuthentication This property can be Enabled/Disabled to allow or deny access with the current access keys. Can be updated even after database is created. 'Disabled'
'Enabled'
clientProtocol Specifies whether redis clients can connect using TLS-encrypted or plaintext redis protocols. Default is TLS-encrypted. 'Encrypted'
'Plaintext'
clusteringPolicy Clustering policy - default is OSSCluster. This property can be updated only if the current value is NoCluster. If the value is OSSCluster or EnterpriseCluster, it cannot be updated without deleting the database. 'EnterpriseCluster'
'NoCluster'
'OSSCluster'
deferUpgrade Option to defer upgrade when newest version is released - default is NotDeferred. Learn more: https://aka.ms/redisversionupgrade 'Deferred'
'NotDeferred'
evictionPolicy Redis eviction policy - default is VolatileLRU 'AllKeysLFU'
'AllKeysLRU'
'AllKeysRandom'
'NoEviction'
'VolatileLFU'
'VolatileLRU'
'VolatileRandom'
'VolatileTTL'
geoReplication Optional set of properties to configure geo replication for this database. DatabasePropertiesGeoReplication
modules Optional set of redis modules to enable in this database - modules can only be added at creation time. Module[]
persistence Persistence settings Persistence
port TCP port of the database endpoint. Specified at create time. Defaults to an available port. int

DatabasePropertiesGeoReplication

Name Description Value
groupNickname Name for the group of linked database resources string
linkedDatabases List of database resources to link with this database LinkedDatabase[]

LinkedDatabase

Name Description Value
id Resource ID of a database resource to link with this database. string

Module

Name Description Value
args Configuration options for the module, e.g. 'ERROR_RATE 0.01 INITIAL_SIZE 400'. string
name The name of the module, e.g. 'RedisBloom', 'RediSearch', 'RedisTimeSeries' string (required)

Persistence

Name Description Value
aofEnabled Sets whether AOF is enabled. Note that at most one of AOF or RDB persistence may be enabled. bool
aofFrequency Sets the frequency at which data is written to disk. Defaults to '1s', meaning 'every second'. Note that the 'always' setting is deprecated, because of its performance impact. '1s'
'always'
rdbEnabled Sets whether RDB is enabled. Note that at most one of AOF or RDB persistence may be enabled. bool
rdbFrequency Sets the frequency at which a snapshot of the database is created. '12h'
'1h'
'6h'

Usage Examples

Azure Quickstart Samples

The following Azure Quickstart templates contain Bicep samples for deploying this resource type.

Bicep File Description
Redis Enterprise with Vector DB This template creates a Redis Cache that can be used as Vector DB to store and query embeddings via indexes. For this feature, the Redis Search module is activated in Azure Redis

ARM template resource definition

The redisEnterprise/databases resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Cache/redisEnterprise/databases resource, add the following JSON to your template.

{
  "type": "Microsoft.Cache/redisEnterprise/databases",
  "apiVersion": "2025-08-01-preview",
  "name": "string",
  "properties": {
    "accessKeysAuthentication": "string",
    "clientProtocol": "string",
    "clusteringPolicy": "string",
    "deferUpgrade": "string",
    "evictionPolicy": "string",
    "geoReplication": {
      "groupNickname": "string",
      "linkedDatabases": [
        {
          "id": "string"
        }
      ]
    },
    "modules": [
      {
        "args": "string",
        "name": "string"
      }
    ],
    "persistence": {
      "aofEnabled": "bool",
      "aofFrequency": "string",
      "rdbEnabled": "bool",
      "rdbFrequency": "string"
    },
    "port": "int"
  }
}

Property Values

Microsoft.Cache/redisEnterprise/databases

Name Description Value
apiVersion The api version '2025-08-01-preview'
name The resource name string

Constraints:
Pattern = ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ (required)
properties Other properties of the database. DatabaseCreateProperties
type The resource type 'Microsoft.Cache/redisEnterprise/databases'

DatabaseCreateProperties

Name Description Value
accessKeysAuthentication This property can be Enabled/Disabled to allow or deny access with the current access keys. Can be updated even after database is created. 'Disabled'
'Enabled'
clientProtocol Specifies whether redis clients can connect using TLS-encrypted or plaintext redis protocols. Default is TLS-encrypted. 'Encrypted'
'Plaintext'
clusteringPolicy Clustering policy - default is OSSCluster. This property can be updated only if the current value is NoCluster. If the value is OSSCluster or EnterpriseCluster, it cannot be updated without deleting the database. 'EnterpriseCluster'
'NoCluster'
'OSSCluster'
deferUpgrade Option to defer upgrade when newest version is released - default is NotDeferred. Learn more: https://aka.ms/redisversionupgrade 'Deferred'
'NotDeferred'
evictionPolicy Redis eviction policy - default is VolatileLRU 'AllKeysLFU'
'AllKeysLRU'
'AllKeysRandom'
'NoEviction'
'VolatileLFU'
'VolatileLRU'
'VolatileRandom'
'VolatileTTL'
geoReplication Optional set of properties to configure geo replication for this database. DatabasePropertiesGeoReplication
modules Optional set of redis modules to enable in this database - modules can only be added at creation time. Module[]
persistence Persistence settings Persistence
port TCP port of the database endpoint. Specified at create time. Defaults to an available port. int

DatabasePropertiesGeoReplication

Name Description Value
groupNickname Name for the group of linked database resources string
linkedDatabases List of database resources to link with this database LinkedDatabase[]

LinkedDatabase

Name Description Value
id Resource ID of a database resource to link with this database. string

Module

Name Description Value
args Configuration options for the module, e.g. 'ERROR_RATE 0.01 INITIAL_SIZE 400'. string
name The name of the module, e.g. 'RedisBloom', 'RediSearch', 'RedisTimeSeries' string (required)

Persistence

Name Description Value
aofEnabled Sets whether AOF is enabled. Note that at most one of AOF or RDB persistence may be enabled. bool
aofFrequency Sets the frequency at which data is written to disk. Defaults to '1s', meaning 'every second'. Note that the 'always' setting is deprecated, because of its performance impact. '1s'
'always'
rdbEnabled Sets whether RDB is enabled. Note that at most one of AOF or RDB persistence may be enabled. bool
rdbFrequency Sets the frequency at which a snapshot of the database is created. '12h'
'1h'
'6h'

Usage Examples

Azure Quickstart Templates

The following Azure Quickstart templates deploy this resource type.

Template Description
Redis Enterprise with Vector DB

Deploy to Azure		 This template creates a Redis Cache that can be used as Vector DB to store and query embeddings via indexes. For this feature, the Redis Search module is activated in Azure Redis

Terraform (AzAPI provider) resource definition

The redisEnterprise/databases resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Cache/redisEnterprise/databases resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Cache/redisEnterprise/databases@2025-08-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      accessKeysAuthentication = "string"
      clientProtocol = "string"
      clusteringPolicy = "string"
      deferUpgrade = "string"
      evictionPolicy = "string"
      geoReplication = {
        groupNickname = "string"
        linkedDatabases = [
          {
            id = "string"
          }
        ]
      }
      modules = [
        {
          args = "string"
          name = "string"
        }
      ]
      persistence = {
        aofEnabled = bool
        aofFrequency = "string"
        rdbEnabled = bool
        rdbFrequency = "string"
      }
      port = int
    }
  }
}

Property Values

Microsoft.Cache/redisEnterprise/databases

Name Description Value
name The resource name string

Constraints:
Pattern = ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ (required)
parent_id The ID of the resource that is the parent for this resource. ID for resource of type: redisEnterprise
properties Other properties of the database. DatabaseCreateProperties
type The resource type "Microsoft.Cache/redisEnterprise/databases@2025-08-01-preview"

DatabaseCreateProperties

Name Description Value
accessKeysAuthentication This property can be Enabled/Disabled to allow or deny access with the current access keys. Can be updated even after database is created. 'Disabled'
'Enabled'
clientProtocol Specifies whether redis clients can connect using TLS-encrypted or plaintext redis protocols. Default is TLS-encrypted. 'Encrypted'
'Plaintext'
clusteringPolicy Clustering policy - default is OSSCluster. This property can be updated only if the current value is NoCluster. If the value is OSSCluster or EnterpriseCluster, it cannot be updated without deleting the database. 'EnterpriseCluster'
'NoCluster'
'OSSCluster'
deferUpgrade Option to defer upgrade when newest version is released - default is NotDeferred. Learn more: https://aka.ms/redisversionupgrade 'Deferred'
'NotDeferred'
evictionPolicy Redis eviction policy - default is VolatileLRU 'AllKeysLFU'
'AllKeysLRU'
'AllKeysRandom'
'NoEviction'
'VolatileLFU'
'VolatileLRU'
'VolatileRandom'
'VolatileTTL'
geoReplication Optional set of properties to configure geo replication for this database. DatabasePropertiesGeoReplication
modules Optional set of redis modules to enable in this database - modules can only be added at creation time. Module[]
persistence Persistence settings Persistence
port TCP port of the database endpoint. Specified at create time. Defaults to an available port. int

DatabasePropertiesGeoReplication

Name Description Value
groupNickname Name for the group of linked database resources string
linkedDatabases List of database resources to link with this database LinkedDatabase[]

LinkedDatabase

Name Description Value
id Resource ID of a database resource to link with this database. string

Module

Name Description Value
args Configuration options for the module, e.g. 'ERROR_RATE 0.01 INITIAL_SIZE 400'. string
name The name of the module, e.g. 'RedisBloom', 'RediSearch', 'RedisTimeSeries' string (required)

Persistence

Name Description Value
aofEnabled Sets whether AOF is enabled. Note that at most one of AOF or RDB persistence may be enabled. bool
aofFrequency Sets the frequency at which data is written to disk. Defaults to '1s', meaning 'every second'. Note that the 'always' setting is deprecated, because of its performance impact. '1s'
'always'
rdbEnabled Sets whether RDB is enabled. Note that at most one of AOF or RDB persistence may be enabled. bool
rdbFrequency Sets the frequency at which a snapshot of the database is created. '12h'
'1h'
'6h'

Usage Examples

Terraform Samples

A basic example of deploying Redis Enterprise Database.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "redisEnterprise" {
  type      = "Microsoft.Cache/redisEnterprise@2025-04-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      minimumTlsVersion = "1.2"
      encryption        = {}
      highAvailability  = "Enabled"
    }
    sku = {
      name = "Balanced_B0"
    }
  }

  identity {
    type         = "SystemAssigned"
    identity_ids = []
  }

  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "defaultDatabase" {
  type      = "Microsoft.Cache/redisEnterprise/databases@2025-04-01"
  parent_id = azapi_resource.redisEnterprise.id
  name      = "default"
  body = {
    properties = {
      clientProtocol   = "Encrypted"
      clusteringPolicy = "OSSCluster"
      evictionPolicy   = "VolatileLRU"
      modules          = []
      port             = 10000
    }
  }
}
  • Last updated on