Microsoft.Cache redis

Definición de recursos de Bicep

El tipo de recurso redis se puede implementar con operaciones que tienen como destino:

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@2024-11-01' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    disableAccessKeyAuthentication: bool
    enableNonSslPort: bool
    minimumTlsVersion: 'string'
    publicNetworkAccess: 'string'
    redisConfiguration: {
      aad-enabled: 'string'
      aof-backup-enabled: 'string'
      aof-storage-connection-string-0: 'string'
      aof-storage-connection-string-1: 'string'
      authnotrequired: 'string'
      maxfragmentationmemory-reserved: 'string'
      maxmemory-delta: 'string'
      maxmemory-policy: 'string'
      maxmemory-reserved: 'string'
      notify-keyspace-events: 'string'
      preferred-data-persistence-auth-method: 'string'
      rdb-backup-enabled: 'string'
      rdb-backup-frequency: 'string'
      rdb-backup-max-snapshot-count: 'string'
      rdb-storage-connection-string: 'string'
      storage-subscription-id: 'string'
    }
    redisVersion: 'string'
    replicasPerMaster: int
    replicasPerPrimary: int
    shardCount: int
    sku: {
      capacity: int
      family: 'string'
      name: 'string'
    }
    staticIP: 'string'
    subnetId: 'string'
    tenantSettings: {
      {customized property}: 'string'
    }
    updateChannel: 'string'
    zonalAllocationPolicy: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

Valores de propiedad

Microsoft.Cache/redis

ManagedServiceIdentity

RedisCommonPropertiesRedisConfiguration

RedisCommonPropertiesTenantSettings

RedisCreateParametersTags

RedisCreatePropertiesOrRedisProperties

SKU

UserAssignedIdentities

IdentidadAsignadaPorElUsuario

Ejemplos de uso

Módulos comprobados de Azure

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

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.

Definición de recursos de plantilla de ARM

El tipo de recurso redis se puede implementar con operaciones que tienen como destino:

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": "2024-11-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "disableAccessKeyAuthentication": "bool",
    "enableNonSslPort": "bool",
    "minimumTlsVersion": "string",
    "publicNetworkAccess": "string",
    "redisConfiguration": {
      "aad-enabled": "string",
      "aof-backup-enabled": "string",
      "aof-storage-connection-string-0": "string",
      "aof-storage-connection-string-1": "string",
      "authnotrequired": "string",
      "maxfragmentationmemory-reserved": "string",
      "maxmemory-delta": "string",
      "maxmemory-policy": "string",
      "maxmemory-reserved": "string",
      "notify-keyspace-events": "string",
      "preferred-data-persistence-auth-method": "string",
      "rdb-backup-enabled": "string",
      "rdb-backup-frequency": "string",
      "rdb-backup-max-snapshot-count": "string",
      "rdb-storage-connection-string": "string",
      "storage-subscription-id": "string"
    },
    "redisVersion": "string",
    "replicasPerMaster": "int",
    "replicasPerPrimary": "int",
    "shardCount": "int",
    "sku": {
      "capacity": "int",
      "family": "string",
      "name": "string"
    },
    "staticIP": "string",
    "subnetId": "string",
    "tenantSettings": {
      "{customized property}": "string"
    },
    "updateChannel": "string",
    "zonalAllocationPolicy": "string"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

Valores de propiedad

Microsoft.Cache/redis

ManagedServiceIdentity

RedisCommonPropertiesRedisConfiguration

RedisCommonPropertiesTenantSettings

RedisCreateParametersTags

RedisCreatePropertiesOrRedisProperties

SKU

UserAssignedIdentities

IdentidadAsignadaPorElUsuario

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	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 instancia de Web App + Redis Cache + SQL DB con una plantilla	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	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.
Crear dos cachés con replicación geográfica en una red virtual	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	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	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	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 que tienen como destino:

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@2024-11-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      disableAccessKeyAuthentication = bool
      enableNonSslPort = bool
      minimumTlsVersion = "string"
      publicNetworkAccess = "string"
      redisConfiguration = {
        aad-enabled = "string"
        aof-backup-enabled = "string"
        aof-storage-connection-string-0 = "string"
        aof-storage-connection-string-1 = "string"
        authnotrequired = "string"
        maxfragmentationmemory-reserved = "string"
        maxmemory-delta = "string"
        maxmemory-policy = "string"
        maxmemory-reserved = "string"
        notify-keyspace-events = "string"
        preferred-data-persistence-auth-method = "string"
        rdb-backup-enabled = "string"
        rdb-backup-frequency = "string"
        rdb-backup-max-snapshot-count = "string"
        rdb-storage-connection-string = "string"
        storage-subscription-id = "string"
      }
      redisVersion = "string"
      replicasPerMaster = int
      replicasPerPrimary = int
      shardCount = int
      sku = {
        capacity = int
        family = "string"
        name = "string"
      }
      staticIP = "string"
      subnetId = "string"
      tenantSettings = {
        {customized property} = "string"
      }
      updateChannel = "string"
      zonalAllocationPolicy = "string"
    }
    zones = [
      "string"
    ]
  }
}

Valores de propiedad

Microsoft.Cache/redis

ManagedServiceIdentity

RedisCommonPropertiesRedisConfiguration

RedisCommonPropertiesTenantSettings

RedisCreateParametersTags

RedisCreatePropertiesOrRedisProperties

SKU

UserAssignedIdentities

IdentidadAsignadaPorElUsuario

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.