Compartir a través de

Databases - Create

Servicio:
Redis Cache
Versión de la API:
2025-07-01

Crea una base de datos

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}?api-version=2025-07-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
clusterName
 path True

string

pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$

Nombre del clúster de Redis Enterprise. El nombre debe tener entre 1 y 60 caracteres. Caracteres permitidos (A-Z, a-z, 0-9) y guion(-). No puede haber guiones iniciales ni finales ni consecutivos
databaseName
 path True

string

pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$

Nombre de la base de datos de Redis Enterprise.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId
 path True

string

minLength: 1

Identificador de la suscripción de destino.
api-version
 query True

string

minLength: 1

Versión de API que se usará para esta operación.

Cuerpo de la solicitud

Nombre Tipo Description
properties.accessKeysAuthentication

accessKeysAuthentication

Esta propiedad puede estar habilitada o deshabilitada para permitir o denegar el acceso con las claves de acceso actuales. Se puede actualizar incluso después de crear la base de datos. El valor predeterminado es Deshabilitado.
properties.clientProtocol

Protocol

Especifica si los clientes de Redis pueden conectarse mediante protocolos de redis cifrados mediante TLS o con texto no cifrado. El valor predeterminado es TLS cifrado.
properties.clusteringPolicy

ClusteringPolicy

Directiva de agrupación en clústeres: el valor predeterminado es OSSCluster. Esta propiedad solo se puede actualizar si el valor actual es NoCluster. Si el valor es OSSCluster o EnterpriseCluster, no se puede actualizar sin eliminar la base de datos.
properties.deferUpgrade

DeferUpgradeSetting

Opción para aplazar la actualización cuando se publica la versión más reciente: el valor predeterminado es NotDeferred. Aprende más: https://aka.ms/redisversionupgrade
properties.evictionPolicy

EvictionPolicy

Directiva de expulsión de Redis: el valor predeterminado es VolatileLRU
properties.geoReplication

GeoReplication

Conjunto opcional de propiedades para configurar la replicación geográfica para esta base de datos.
properties.modules

Module[]

Conjunto opcional de módulos de redis que se habilitarán en esta base de datos: los módulos solo se pueden agregar en tiempo de creación.
properties.persistence

Persistence

Configuración de persistencia
Configuración de persistencia
properties.port

integer (int32)

Puerto TCP del punto de conexión de la base de datos. Especificado en tiempo de creación. El valor predeterminado es un puerto disponible.

Respuestas

Nombre Tipo Description
200 OK

Database

La base de datos se estaba actualizando o se está actualizando. Compruebe provisioningState y resourceState para conocer el estado detallado.
201 Created

Database

La base de datos se estaba creando o se está creando. Compruebe provisioningState y resourceState para conocer el estado detallado.
Other Status Codes

ErrorResponse

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

RedisEnterpriseDatabasesCreate
RedisEnterpriseDatabasesCreate No Cluster Cache
RedisEnterpriseDatabasesCreate With Active Geo Replication

RedisEnterpriseDatabasesCreate

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default?api-version=2025-07-01

{
  "properties": {
    "clientProtocol": "Encrypted",
    "clusteringPolicy": "EnterpriseCluster",
    "evictionPolicy": "AllKeysLRU",
    "persistence": {
      "aofEnabled": true,
      "aofFrequency": "1s"
    },
    "port": 10000,
    "modules": [
      {
        "name": "RedisBloom",
        "args": "ERROR_RATE 0.00 INITIAL_SIZE 400"
      },
      {
        "name": "RedisTimeSeries",
        "args": "RETENTION_POLICY 20"
      },
      {
        "name": "RediSearch"
      }
    ],
    "deferUpgrade": "NotDeferred",
    "accessKeysAuthentication": "Enabled"
  }
}

Respuesta de muestra

status code:
200 
{
  "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
  "name": "cache1/default",
  "type": "Microsoft.Cache/redisEnterprise/databases",
  "properties": {
    "provisioningState": "Updating",
    "resourceState": "Updating",
    "clientProtocol": "Encrypted",
    "clusteringPolicy": "EnterpriseCluster",
    "evictionPolicy": "AllKeysLRU",
    "persistence": {
      "aofEnabled": true,
      "aofFrequency": "1s"
    },
    "port": 10000,
    "modules": [
      {
        "name": "RedisBloom",
        "args": "ERROR_RATE 0.00 INITIAL_SIZE 400",
        "version": "1.0.0"
      },
      {
        "name": "RedisTimeSeries",
        "args": "RETENTION_POLICY 20",
        "version": "1.0.0"
      },
      {
        "name": "RediSearch",
        "args": "",
        "version": "1.0.0"
      }
    ],
    "deferUpgrade": "NotDeferred",
    "accessKeysAuthentication": "Enabled",
    "redisVersion": "6.0"
  }
}
status code:
201 
{
  "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/db1",
  "name": "cache1/db1",
  "type": "Microsoft.Cache/redisEnterprise/databases",
  "properties": {
    "provisioningState": "Creating",
    "resourceState": "Creating",
    "clientProtocol": "Encrypted",
    "clusteringPolicy": "EnterpriseCluster",
    "evictionPolicy": "AllKeysLRU",
    "persistence": {
      "aofEnabled": true,
      "aofFrequency": "1s"
    },
    "port": 10000,
    "modules": [
      {
        "name": "RedisBloom",
        "args": "ERROR_RATE 0.00 INITIAL_SIZE 400",
        "version": "1.0.0"
      },
      {
        "name": "RedisTimeSeries",
        "args": "RETENTION_POLICY 20",
        "version": "1.0.0"
      },
      {
        "name": "RediSearch",
        "args": "",
        "version": "1.0.0"
      }
    ],
    "accessKeysAuthentication": "Enabled"
  }
}

RedisEnterpriseDatabasesCreate No Cluster Cache

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default?api-version=2025-07-01

{
  "properties": {
    "clientProtocol": "Encrypted",
    "clusteringPolicy": "NoCluster",
    "evictionPolicy": "NoEviction",
    "port": 10000
  }
}

Respuesta de muestra

status code:
201 
{
  "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
  "name": "cache1/default",
  "type": "Microsoft.Cache/redisEnterprise/databases",
  "properties": {
    "clientProtocol": "Encrypted",
    "port": 10000,
    "provisioningState": "Creating",
    "resourceState": "Creating",
    "clusteringPolicy": "NoCluster",
    "evictionPolicy": "NoEviction",
    "deferUpgrade": "NotDeferred",
    "redisVersion": "7.2",
    "accessKeysAuthentication": "Enabled"
  }
}
status code:
200 
{
  "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
  "name": "cache1/default",
  "type": "Microsoft.Cache/redisEnterprise/databases",
  "properties": {
    "clientProtocol": "Encrypted",
    "port": 10000,
    "provisioningState": "Updating",
    "resourceState": "Updating",
    "clusteringPolicy": "NoCluster",
    "evictionPolicy": "NoEviction",
    "deferUpgrade": "NotDeferred",
    "redisVersion": "7.2",
    "accessKeysAuthentication": "Enabled"
  }
}

RedisEnterpriseDatabasesCreate With Active Geo Replication

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default?api-version=2025-07-01

{
  "properties": {
    "clientProtocol": "Encrypted",
    "clusteringPolicy": "EnterpriseCluster",
    "evictionPolicy": "NoEviction",
    "port": 10000,
    "accessKeysAuthentication": "Enabled",
    "geoReplication": {
      "groupNickname": "groupName",
      "linkedDatabases": [
        {
          "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default"
        },
        {
          "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8e/resourceGroups/rg2/providers/Microsoft.Cache/redisEnterprise/cache2/databases/default"
        }
      ]
    }
  }
}

Respuesta de muestra

status code:
200 
{
  "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
  "name": "cache1/default",
  "type": "Microsoft.Cache/redisEnterprise/databases",
  "properties": {
    "provisioningState": "Updating",
    "resourceState": "Updating",
    "clientProtocol": "Encrypted",
    "clusteringPolicy": "EnterpriseCluster",
    "evictionPolicy": "NoEviction",
    "port": 10000,
    "geoReplication": {
      "groupNickname": "groupName",
      "linkedDatabases": [
        {
          "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8e/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
          "state": "Linking"
        },
        {
          "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f2/resourceGroups/rg2/providers/Microsoft.Cache/redisEnterprise/cache2/databases/default",
          "state": "Linking"
        }
      ]
    },
    "deferUpgrade": "NotDeferred",
    "accessKeysAuthentication": "Enabled",
    "redisVersion": "6.0"
  }
}
status code:
201 
{
  "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/db1",
  "name": "cache1/db1",
  "type": "Microsoft.Cache/redisEnterprise/databases",
  "properties": {
    "provisioningState": "Creating",
    "resourceState": "Creating",
    "clientProtocol": "Plaintext",
    "clusteringPolicy": "EnterpriseCluster",
    "evictionPolicy": "NoEviction",
    "port": 10000,
    "geoReplication": {
      "groupNickname": "groupName",
      "linkedDatabases": [
        {
          "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8e/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
          "state": "Linking"
        },
        {
          "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f2/resourceGroups/rg2/providers/Microsoft.Cache/redisEnterprise/cache2/databases/default",
          "state": "Linking"
        }
      ]
    },
    "deferUpgrade": "NotDeferred",
    "accessKeysAuthentication": "Enabled",
    "redisVersion": "6.0"
  }
}

Definiciones

Nombre Description
accessKeysAuthentication

Esta propiedad puede estar habilitada o deshabilitada para permitir o denegar el acceso con las claves de acceso actuales. Se puede actualizar incluso después de crear la base de datos. El valor predeterminado es Deshabilitado.
AofFrequency

Establece la frecuencia con la que se escriben los datos en el disco. El valor predeterminado es "1s", lo que significa "cada segundo". Tenga en cuenta que la configuración "always" está en desuso, debido a su impacto en el rendimiento.
ClusteringPolicy

Directiva de agrupación en clústeres: el valor predeterminado es OSSCluster. Esta propiedad solo se puede actualizar si el valor actual es NoCluster. Si el valor es OSSCluster o EnterpriseCluster, no se puede actualizar sin eliminar la base de datos.
Database

Describe una base de datos en el clúster de Redis Enterprise
DeferUpgradeSetting

Opción para aplazar la actualización cuando se publica la versión más reciente: el valor predeterminado es NotDeferred. Aprende más: https://aka.ms/redisversionupgrade
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.
ErrorDetail

Detalle del error.
ErrorResponse

Respuesta de error
EvictionPolicy

Directiva de expulsión de Redis: el valor predeterminado es VolatileLRU
GeoReplication

Conjunto opcional de propiedades para configurar la replicación geográfica para esta base de datos.
LinkedDatabase

Base de datos vinculada
LinkState

Estado del vínculo entre los recursos de la base de datos.
Module

Configuración del módulo
Persistence

Configuración de persistencia
Protocol

Especifica si los clientes de Redis pueden conectarse mediante protocolos de redis cifrados mediante TLS o con texto no cifrado. El valor predeterminado es TLS cifrado.
ProvisioningState

Estado actual del aprovisionamiento
RdbFrequency

Establece la frecuencia con la que se crea una instantánea de la base de datos.
ResourceState

Estado actual de los recursos

accessKeysAuthentication

Enumeración

Esta propiedad puede estar habilitada o deshabilitada para permitir o denegar el acceso con las claves de acceso actuales. Se puede actualizar incluso después de crear la base de datos. El valor predeterminado es Deshabilitado.

Valor Description
Disabled
Enabled

AofFrequency

Enumeración

Establece la frecuencia con la que se escriben los datos en el disco. El valor predeterminado es "1s", lo que significa "cada segundo". Tenga en cuenta que la configuración "always" está en desuso, debido a su impacto en el rendimiento.

Valor Description
1s
always

ClusteringPolicy

Enumeración

Directiva de agrupación en clústeres: el valor predeterminado es OSSCluster. Esta propiedad solo se puede actualizar si el valor actual es NoCluster. Si el valor es OSSCluster o EnterpriseCluster, no se puede actualizar sin eliminar la base de datos.

Valor Description
EnterpriseCluster

La directiva de clústeres empresariales solo utiliza el protocolo redis clásico, que no admite comandos de clúster redis.
OSSCluster

La directiva de clústeres de OSS sigue la especificación de clúster de redis y requiere que todos los clientes admitan la agrupación en clústeres de redis.
NoCluster

La directiva NoCluster se utiliza para instancias de Redis no agrupadas en clústeres que no requieren funciones de agrupación en clústeres.

Database

Objeto

Describe una base de datos en el clúster de Redis Enterprise

Nombre Tipo Valor predeterminado Description
id

string

Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

Nombre del recurso
properties.accessKeysAuthentication

accessKeysAuthentication

Disabled

Esta propiedad puede estar habilitada o deshabilitada para permitir o denegar el acceso con las claves de acceso actuales. Se puede actualizar incluso después de crear la base de datos. El valor predeterminado es Deshabilitado.
properties.clientProtocol

Protocol

Especifica si los clientes de Redis pueden conectarse mediante protocolos de redis cifrados mediante TLS o con texto no cifrado. El valor predeterminado es TLS cifrado.
properties.clusteringPolicy

ClusteringPolicy

Directiva de agrupación en clústeres: el valor predeterminado es OSSCluster. Esta propiedad solo se puede actualizar si el valor actual es NoCluster. Si el valor es OSSCluster o EnterpriseCluster, no se puede actualizar sin eliminar la base de datos.
properties.deferUpgrade

DeferUpgradeSetting

Opción para aplazar la actualización cuando se publica la versión más reciente: el valor predeterminado es NotDeferred. Aprende más: https://aka.ms/redisversionupgrade
properties.evictionPolicy

EvictionPolicy

Directiva de expulsión de Redis: el valor predeterminado es VolatileLRU
properties.geoReplication

GeoReplication

Conjunto opcional de propiedades para configurar la replicación geográfica para esta base de datos.
properties.modules

Module[]

Conjunto opcional de módulos de redis que se habilitarán en esta base de datos: los módulos solo se pueden agregar en tiempo de creación.
properties.persistence

Persistence

Configuración de persistencia
Configuración de persistencia
properties.port

integer (int32)

Puerto TCP del punto de conexión de la base de datos. Especificado en tiempo de creación. El valor predeterminado es un puerto disponible.
properties.provisioningState

ProvisioningState

Estado actual de aprovisionamiento de la base de datos
properties.redisVersion

string

Versión de Redis en la que se ejecuta la base de datos, por ejemplo, '6.0'
properties.resourceState

ResourceState

Estado actual de los recursos de la base de datos
type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

DeferUpgradeSetting

Enumeración

Opción para aplazar la actualización cuando se publica la versión más reciente: el valor predeterminado es NotDeferred. Aprende más: https://aka.ms/redisversionupgrade

Valor Description
Deferred
NotDeferred

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.
type

string

Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.
code

string

Código de error.
details

ErrorDetail[]

Detalles del error.
message

string

El mensaje de error.
target

string

Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

EvictionPolicy

Enumeración

Directiva de expulsión de Redis: el valor predeterminado es VolatileLRU

Valor Description
AllKeysLFU
AllKeysLRU
AllKeysRandom
VolatileLRU
VolatileLFU
VolatileTTL
VolatileRandom
NoEviction

GeoReplication

Objeto

Conjunto opcional de propiedades para configurar la replicación geográfica para esta base de datos.

Nombre Tipo Description
groupNickname

string

Nombre del grupo de recursos de base de datos vinculados
linkedDatabases

LinkedDatabase[]

Lista de recursos de base de datos para vincular con esta base de datos

LinkedDatabase

Objeto

Base de datos vinculada

Nombre Tipo Description
id

string (arm-id)

Identificador de recurso de un recurso de base de datos que se va a vincular con esta base de datos.
state

LinkState

Estado del vínculo entre los recursos de la base de datos.

LinkState

Enumeración

Estado del vínculo entre los recursos de la base de datos.

Valor Description
Linked
Linking
Unlinking
LinkFailed
UnlinkFailed

Module

Objeto

Configuración del módulo

Nombre Tipo Description
args

string

Opciones de configuración para el módulo, por ejemplo, "ERROR_RATE 0,01 INITIAL_SIZE 400".
name

string

Nombre del módulo, por ejemplo, "RedisBloom", "RediSearch", "RedisTimeSeries"
version

string

La versión del módulo, por ejemplo, '1.0'.

Persistence

Objeto

Configuración de persistencia

Nombre Tipo Description
aofEnabled

boolean

Establece si AOF está habilitado. Tenga en cuenta que, como máximo, se puede habilitar la persistencia de AOF o RDB.
aofFrequency

AofFrequency

Establece la frecuencia con la que se escriben los datos en el disco. El valor predeterminado es "1s", lo que significa "cada segundo". Tenga en cuenta que la configuración "always" está en desuso, debido a su impacto en el rendimiento.
rdbEnabled

boolean

Establece si RDB está habilitado. Tenga en cuenta que, como máximo, se puede habilitar la persistencia de AOF o RDB.
rdbFrequency

RdbFrequency

Establece la frecuencia con la que se crea una instantánea de la base de datos.

Protocol

Enumeración

Especifica si los clientes de Redis pueden conectarse mediante protocolos de redis cifrados mediante TLS o con texto no cifrado. El valor predeterminado es TLS cifrado.

Valor Description
Encrypted
Plaintext

ProvisioningState

Enumeración

Estado actual del aprovisionamiento

Valor Description
Succeeded
Failed
Canceled
Creating
Updating
Deleting

RdbFrequency

Enumeración

Establece la frecuencia con la que se crea una instantánea de la base de datos.

Valor Description
1h
6h
12h

ResourceState

Enumeración

Estado actual de los recursos

Valor Description
Running
Creating
CreateFailed
Updating
UpdateFailed
Deleting
DeleteFailed
Enabling
EnableFailed
Disabling
DisableFailed
Disabled
Scaling
ScalingFailed
Moving