Compartir a través de


Microsoft.Cache Redis 2017-10-01

Definición de recursos de Bicep

El tipo de recurso redis se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Cache/Redis, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Cache/Redis@2017-10-01' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    enableNonSslPort: bool
    redisConfiguration: {
      {customized property}: 'string'
    }
    shardCount: int
    sku: {
      capacity: int
      family: 'string'
      name: 'string'
    }
    staticIP: 'string'
    subnetId: 'string'
    tenantSettings: {
      {customized property}: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

Valores de propiedad

Microsoft.Cache/Redis

Nombre Descripción Valor
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Propiedades de caché de Redis. RedisCreatePropertiesOrRedisProperties (obligatorio)
scope Use al crear un recurso en un ámbito diferente del ámbito de implementación. Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
Zonas Lista de zonas de disponibilidad de las que se indica dónde debe proceder el recurso. cadena[]

RedisCommonPropertiesRedisConfiguration

Nombre Descripción Valor

RedisCommonPropertiesTenantSettings

Nombre Descripción Valor

RedisCreateParametersTags

Nombre Descripción Valor

RedisCreatePropertiesOrRedisProperties

Nombre Descripción Valor
enableNonSslPort Especifica si el puerto de servidor redis no ssl (6379) está habilitado. Bool
redisConfiguration Toda la configuración de Redis. Pocas claves posibles: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta,maxmemory-policy,notify-keyspace-events,maxmemory-samples,slowlog-log-slow-than,slowlog-max-len,list-max-ziplist-entries,list-max-ziplist-value,hash-max-ziplist-entries,hash-max-ziplist-value,set-max-intset-entries,zset-max-ziplist-entries,zset-max-ziplist-value, etc. RedisCommonPropertiesRedisConfiguration
shardCount Número de particiones que se van a crear en una caché de clúster premium. Int
Sku SKU de la caché de Redis que se va a implementar. de Sku (obligatorio)
staticIP Dirección IP estática. Necesario al implementar una caché de Redis dentro de una instancia de Azure Virtual Network existente. cuerda

Restricciones:
Patrón = ^\d+\.\d+\.\d+\.\d+$
subnetId Identificador de recurso completo de una subred de una red virtual en la que se va a implementar la caché de Redis. Formato de ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Network|ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1 cuerda

Restricciones:
Patrón = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
tenantSettings Diccionario de la configuración del inquilino redisCommonPropertiesTenantSettings

SKU

Nombre Descripción Valor
capacidad Tamaño de la caché de Redis que se va a implementar. Valores válidos: para la familia C (Básico/Estándar) (0, 1, 2, 3, 4, 5, 6), para la familia P (Premium) (1, 2, 3, 4). int (obligatorio)
familia Familia de SKU que se va a usar. Valores válidos: (C, P). (C = Básico/Estándar, P = Premium). 'C'
'P' (obligatorio)
nombre Tipo de caché de Redis que se va a implementar. Valores válidos: (Básico, Estándar, Premium) "Básico"
'Premium'
'Estándar' (obligatorio)

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo Descripción
redis Cache Módulo de recursos de AVM para Redis Cache

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep Descripción
Creación de una instancia de Premium Redis Cache con clústeres Esta plantilla muestra cómo configurar la agrupación en clústeres en una instancia premium de Azure Redis Cache.
Creación de una instancia de Redis Cache mediante una plantilla Esta plantilla crea una instancia de Azure Redis Cache con datos de diagnóstico guardados en una cuenta de almacenamiento.
Crear una caché de Redis con la autenticación de Microsoft Entra. Esta plantilla crea una instancia de Redis Cache. A continuación, asigna una directiva de acceso integrada a un usuario de Redis. A continuación, crea una directiva de acceso personalizada. A continuación, asigna la directiva de acceso personalizada a otro usuario de Redis.
Crear una aplicación web más Redis Cache mediante una plantilla Esta plantilla crea una aplicación web de Azure con Redis Cache.
Creación de una instancia de Premium Redis Cache implementada en una red virtual En esta plantilla se muestra cómo implementar una instancia premium de Azure Redis Cache en una red virtual existente.
Crear caché premium de Redis con de persistencia de datos Esta plantilla muestra cómo configurar la persistencia en una instancia premium de Azure Redis Cache.
Implementación de API Management con una instancia externa de Azure Cache for Redis En esta plantilla se muestra cómo crear una instancia de Azure API Management en el nivel consumo con una instancia externa de Azure Cache for Redis como caché externa de API Management.

Definición de recursos de plantilla de ARM

El tipo de recurso redis se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Cache/Redis, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Cache/Redis",
  "apiVersion": "2017-10-01",
  "name": "string",
  "location": "string",
  "properties": {
    "enableNonSslPort": "bool",
    "redisConfiguration": {
      "{customized property}": "string"
    },
    "shardCount": "int",
    "sku": {
      "capacity": "int",
      "family": "string",
      "name": "string"
    },
    "staticIP": "string",
    "subnetId": "string",
    "tenantSettings": {
      "{customized property}": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

Valores de propiedad

Microsoft.Cache/Redis

Nombre Descripción Valor
apiVersion La versión de api '2017-10-01'
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Propiedades de caché de Redis. RedisCreatePropertiesOrRedisProperties (obligatorio)
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso "Microsoft.Cache/Redis"
Zonas Lista de zonas de disponibilidad de las que se indica dónde debe proceder el recurso. cadena[]

RedisCommonPropertiesRedisConfiguration

Nombre Descripción Valor

RedisCommonPropertiesTenantSettings

Nombre Descripción Valor

RedisCreateParametersTags

Nombre Descripción Valor

RedisCreatePropertiesOrRedisProperties

Nombre Descripción Valor
enableNonSslPort Especifica si el puerto de servidor redis no ssl (6379) está habilitado. Bool
redisConfiguration Toda la configuración de Redis. Pocas claves posibles: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta,maxmemory-policy,notify-keyspace-events,maxmemory-samples,slowlog-log-slow-than,slowlog-max-len,list-max-ziplist-entries,list-max-ziplist-value,hash-max-ziplist-entries,hash-max-ziplist-value,set-max-intset-entries,zset-max-ziplist-entries,zset-max-ziplist-value, etc. RedisCommonPropertiesRedisConfiguration
shardCount Número de particiones que se van a crear en una caché de clúster premium. Int
Sku SKU de la caché de Redis que se va a implementar. de Sku (obligatorio)
staticIP Dirección IP estática. Necesario al implementar una caché de Redis dentro de una instancia de Azure Virtual Network existente. cuerda

Restricciones:
Patrón = ^\d+\.\d+\.\d+\.\d+$
subnetId Identificador de recurso completo de una subred de una red virtual en la que se va a implementar la caché de Redis. Formato de ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Network|ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1 cuerda

Restricciones:
Patrón = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
tenantSettings Diccionario de la configuración del inquilino redisCommonPropertiesTenantSettings

SKU

Nombre Descripción Valor
capacidad Tamaño de la caché de Redis que se va a implementar. Valores válidos: para la familia C (Básico/Estándar) (0, 1, 2, 3, 4, 5, 6), para la familia P (Premium) (1, 2, 3, 4). int (obligatorio)
familia Familia de SKU que se va a usar. Valores válidos: (C, P). (C = Básico/Estándar, P = Premium). 'C'
'P' (obligatorio)
nombre Tipo de caché de Redis que se va a implementar. Valores válidos: (Básico, Estándar, Premium) "Básico"
'Premium'
'Estándar' (obligatorio)

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Plantilla Descripción
Creación de una instancia de Premium Redis Cache con clústeres

Implementación en Azure
Esta plantilla muestra cómo configurar la agrupación en clústeres en una instancia premium de Azure Redis Cache.
Creación de una instancia de Redis Cache mediante una plantilla

Implementación en Azure
Esta plantilla crea una instancia de Azure Redis Cache con datos de diagnóstico guardados en una cuenta de almacenamiento.
Crear una caché de Redis con la autenticación de Microsoft Entra.

Implementación en Azure
Esta plantilla crea una instancia de Redis Cache. A continuación, asigna una directiva de acceso integrada a un usuario de Redis. A continuación, crea una directiva de acceso personalizada. A continuación, asigna la directiva de acceso personalizada a otro usuario de Redis.
Crear una instancia de Web App + Redis Cache + SQL DB con una plantilla

Implementación en Azure
Esta plantilla crea una instancia de Azure Web App con Redis Cache y una instancia de SQL Database.
Crear una aplicación web más Redis Cache mediante una plantilla

Implementación en Azure
Esta plantilla crea una aplicación web de Azure con Redis Cache.
Creación de una instancia de Premium Redis Cache implementada en una red virtual

Implementación en Azure
En esta plantilla se muestra cómo implementar una instancia premium de Azure Redis Cache en una red virtual existente.
Crear caché premium de Redis con de persistencia de datos

Implementación en Azure
Esta plantilla muestra cómo configurar la persistencia en una instancia premium de Azure Redis Cache.
Crear dos cachés con replicación geográfica en una red virtual

Implementación en Azure
Esta plantilla muestra cómo implementar dos instancias de Azure Cache for Redis de nivel Premium en redes virtuales independientes y vincularlas con la replicación geográfica.
Implementación de API Management con una instancia externa de Azure Cache for Redis

Implementación en Azure
En esta plantilla se muestra cómo crear una instancia de Azure API Management en el nivel consumo con una instancia externa de Azure Cache for Redis como caché externa de API Management.
sitio web de eShop con de ASE de ILB

Implementación en Azure
Una instancia de App Service Environment es una opción de plan de servicio Premium de Azure App Service que proporciona un entorno totalmente aislado y dedicado para ejecutar de forma segura aplicaciones de Azure App Service a gran escala, incluidas Web Apps, Mobile Apps y API Apps.
web de Umbraco CMS escalable

Implementación en Azure
Esta plantilla proporciona una manera sencilla de implementar una aplicación web cmS de umbraco en Azure App Service Web Apps.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso redis se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Cache/Redis, agregue el siguiente Terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Cache/Redis@2017-10-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      enableNonSslPort = bool
      redisConfiguration = {
        {customized property} = "string"
      }
      shardCount = int
      sku = {
        capacity = int
        family = "string"
        name = "string"
      }
      staticIP = "string"
      subnetId = "string"
      tenantSettings = {
        {customized property} = "string"
      }
    }
    zones = [
      "string"
    ]
  }
}

Valores de propiedad

Microsoft.Cache/Redis

Nombre Descripción Valor
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso string (obligatorio)
parent_id Identificador del recurso al que se va a aplicar este recurso de extensión. string (obligatorio)
Propiedades Propiedades de caché de Redis. RedisCreatePropertiesOrRedisProperties (obligatorio)
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.Cache/Redis@2017-10-01"
Zonas Lista de zonas de disponibilidad de las que se indica dónde debe proceder el recurso. cadena[]

RedisCommonPropertiesRedisConfiguration

Nombre Descripción Valor

RedisCommonPropertiesTenantSettings

Nombre Descripción Valor

RedisCreateParametersTags

Nombre Descripción Valor

RedisCreatePropertiesOrRedisProperties

Nombre Descripción Valor
enableNonSslPort Especifica si el puerto de servidor redis no ssl (6379) está habilitado. Bool
redisConfiguration Toda la configuración de Redis. Pocas claves posibles: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta,maxmemory-policy,notify-keyspace-events,maxmemory-samples,slowlog-log-slow-than,slowlog-max-len,list-max-ziplist-entries,list-max-ziplist-value,hash-max-ziplist-entries,hash-max-ziplist-value,set-max-intset-entries,zset-max-ziplist-entries,zset-max-ziplist-value, etc. RedisCommonPropertiesRedisConfiguration
shardCount Número de particiones que se van a crear en una caché de clúster premium. Int
Sku SKU de la caché de Redis que se va a implementar. de Sku (obligatorio)
staticIP Dirección IP estática. Necesario al implementar una caché de Redis dentro de una instancia de Azure Virtual Network existente. cuerda

Restricciones:
Patrón = ^\d+\.\d+\.\d+\.\d+$
subnetId Identificador de recurso completo de una subred de una red virtual en la que se va a implementar la caché de Redis. Formato de ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Network|ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1 cuerda

Restricciones:
Patrón = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
tenantSettings Diccionario de la configuración del inquilino redisCommonPropertiesTenantSettings

SKU

Nombre Descripción Valor
capacidad Tamaño de la caché de Redis que se va a implementar. Valores válidos: para la familia C (Básico/Estándar) (0, 1, 2, 3, 4, 5, 6), para la familia P (Premium) (1, 2, 3, 4). int (obligatorio)
familia Familia de SKU que se va a usar. Valores válidos: (C, P). (C = Básico/Estándar, P = Premium). 'C'
'P' (obligatorio)
nombre Tipo de caché de Redis que se va a implementar. Valores válidos: (Básico, Estándar, Premium) "Básico"
'Premium'
'Estándar' (obligatorio)

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación de Redis Cache.

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 = "eastus"
}

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

resource "azapi_resource" "redis" {
  type      = "Microsoft.Cache/redis@2023-04-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      sku = {
        capacity = 2
        family   = "C"
        name     = "Standard"
      }
      enableNonSslPort  = true
      minimumTlsVersion = "1.2"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo Descripción
redis Cache Módulo de recursos de AVM para Redis Cache