Partilhar via


Microsoft.Cache Redis 2016-04-01

Definição de recursos do bíceps

O tipo de recurso Redis pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Cache/Redis, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Cache/Redis@2016-04-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'
  }
}

Valores de propriedade

Microsoft.Cache/Redis

Designação Descrição Valor
localização Localização do recurso. string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades Propriedades do cache Redis. RedisCreatePropertiesOrRedisResourceProperties (obrigatório)
âmbito Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

RedisCreatePropertiesOrRedisResourceProperties

Designação Descrição Valor
enableNonSslPort Especifica se a porta do servidor Redis não ssl (6379) está habilitada. Bool
redisConfiguration Todas as configurações do Redis. Poucas chaves possíveis: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta,maxmemory-policy,notify-keyspace-events,maxmemory-samples,slowlog-log-slower-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. RedisPropertiesRedisConfiguration
Contagem de fragmentos O número de fragmentos a serem criados em um Cache de Cluster Premium. Int
SKU O SKU do cache Redis a ser implantado. Sku (obrigatório)
estáticaIP Endereço IP estático. Necessário ao implantar um cache Redis dentro de uma Rede Virtual do Azure existente. cadeia de caracteres

Restrições:
Padrão = ^\d+\.\d+\.\d+\.\d+$
subnetId O ID de recurso completo de uma sub-rede em uma rede virtual para implantar o cache Redis. Formato de exemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Rede|ClassicNetwork}/VirtualNetworks/vnet1/sub-redes/sub-rede1 cadeia de caracteres

Restrições:
Padrão = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
configurações de locatário configurações de locatário RedisPropertiesTenantSettings

RedisPropertiesRedisConfiguration

Designação Descrição Valor

RedisPropertiesTenantSettings

Designação Descrição Valor

Tags de Recursos

Designação Descrição Valor

Referência

Designação Descrição Valor
capacidade O tamanho do cache Redis a ser implantado. Valores válidos: para a família C (Basic/Standard) (0, 1, 2, 3, 4, 5, 6), para a família P (Premium) (1, 2, 3, 4). int (obrigatório)
Família A família SKU a ser usada. Valores válidos: (C, P). (C = Básico/Padrão, P = Premium). «C»
'P' (obrigatório)
Designação O tipo de cache Redis a ser implantado. Valores válidos: (Básico, Standard, Premium) 'Básico'
'Premium'
'Standard' (obrigatório)

Exemplos de uso

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Módulo Descrição
Cache Redis Módulo de recursos AVM para cache Redis

Exemplos de início rápido do Azure

Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Descrição
Criar um Cache Redis Premium com clustering Este modelo mostra como configurar o clustering em uma instância premium do Cache Redis do Azure.
Criar um Cache Redis usando um modelo Este modelo cria um Cache Redis do Azure com dados de diagnóstico mantidos em uma conta de armazenamento.
Criar um cache Redis com a autenticação do Microsoft Entra. Este modelo cria um Cache Redis. Em seguida, atribui uma política de acesso interna a um usuário redis. Em seguida, cria uma política de acesso personalizada. E, em seguida, atribui a política de acesso personalizada a outro usuário do Redis.
Criar um Aplicativo Web mais Cache Redis usando um modelo Este modelo cria um Aplicativo Web do Azure com cache Redis.
Criar Cache Redis Premium implantado em uma Rede Virtual Este modelo mostra como implantar uma instância premium do Cache Redis do Azure em uma Rede Virtual existente
Criar cache Redis Premium com persistência de dados Este modelo mostra como configurar a persistência em uma instância premium do Cache Redis do Azure.
Implantar o Gerenciamento de API com um Cache do Azure externo para Redis Este modelo demonstra como criar uma instância do Gerenciamento de API do Azure na camada de Consumo com uma instância externa do Cache do Azure para Redis como o cache externo do Gerenciamento de API.

Definição de recurso de modelo ARM

O tipo de recurso Redis pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Cache/Redis, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Cache/Redis",
  "apiVersion": "2016-04-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"
  }
}

Valores de propriedade

Microsoft.Cache/Redis

Designação Descrição Valor
Versão da API A versão api '2016-04-01'
localização Localização do recurso. string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades Propriedades do cache Redis. RedisCreatePropertiesOrRedisResourceProperties (obrigatório)
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.Cache/Redis'

RedisCreatePropertiesOrRedisResourceProperties

Designação Descrição Valor
enableNonSslPort Especifica se a porta do servidor Redis não ssl (6379) está habilitada. Bool
redisConfiguration Todas as configurações do Redis. Poucas chaves possíveis: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta,maxmemory-policy,notify-keyspace-events,maxmemory-samples,slowlog-log-slower-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. RedisPropertiesRedisConfiguration
Contagem de fragmentos O número de fragmentos a serem criados em um Cache de Cluster Premium. Int
SKU O SKU do cache Redis a ser implantado. Sku (obrigatório)
estáticaIP Endereço IP estático. Necessário ao implantar um cache Redis dentro de uma Rede Virtual do Azure existente. cadeia de caracteres

Restrições:
Padrão = ^\d+\.\d+\.\d+\.\d+$
subnetId O ID de recurso completo de uma sub-rede em uma rede virtual para implantar o cache Redis. Formato de exemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Rede|ClassicNetwork}/VirtualNetworks/vnet1/sub-redes/sub-rede1 cadeia de caracteres

Restrições:
Padrão = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
configurações de locatário configurações de locatário RedisPropertiesTenantSettings

RedisPropertiesRedisConfiguration

Designação Descrição Valor

RedisPropertiesTenantSettings

Designação Descrição Valor

Tags de Recursos

Designação Descrição Valor

Referência

Designação Descrição Valor
capacidade O tamanho do cache Redis a ser implantado. Valores válidos: para a família C (Basic/Standard) (0, 1, 2, 3, 4, 5, 6), para a família P (Premium) (1, 2, 3, 4). int (obrigatório)
Família A família SKU a ser usada. Valores válidos: (C, P). (C = Básico/Padrão, P = Premium). «C»
'P' (obrigatório)
Designação O tipo de cache Redis a ser implantado. Valores válidos: (Básico, Standard, Premium) 'Básico'
'Premium'
'Standard' (obrigatório)

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.

Modelo Descrição
Criar um Cache Redis Premium com clustering

Implantar no Azure
Este modelo mostra como configurar o clustering em uma instância premium do Cache Redis do Azure.
Criar um Cache Redis usando um modelo

Implantar no Azure
Este modelo cria um Cache Redis do Azure com dados de diagnóstico mantidos em uma conta de armazenamento.
Criar um cache Redis com a autenticação do Microsoft Entra.

Implantar no Azure
Este modelo cria um Cache Redis. Em seguida, atribui uma política de acesso interna a um usuário redis. Em seguida, cria uma política de acesso personalizada. E, em seguida, atribui a política de acesso personalizada a outro usuário do Redis.
Criar um aplicativo Web + Cache Redis + Banco de Dados SQL com um modelo

Implantar no Azure
Este modelo cria um Aplicativo Web do Azure com cache Redis e um Banco de Dados SQL.
Criar um Aplicativo Web mais Cache Redis usando um modelo

Implantar no Azure
Este modelo cria um Aplicativo Web do Azure com cache Redis.
Criar Cache Redis Premium implantado em uma Rede Virtual

Implantar no Azure
Este modelo mostra como implantar uma instância premium do Cache Redis do Azure em uma Rede Virtual existente
Criar cache Redis Premium com persistência de dados

Implantar no Azure
Este modelo mostra como configurar a persistência em uma instância premium do Cache Redis do Azure.
Crie dois caches replicados geograficamente em uma rede virtual

Implantar no Azure
Este modelo mostra como implantar duas instâncias do Cache do Azure para Redis de camada Premium em Redes Virtuais separadas e vinculá-las à replicação geográfica.
Implantar o Gerenciamento de API com um Cache do Azure externo para Redis

Implantar no Azure
Este modelo demonstra como criar uma instância do Gerenciamento de API do Azure na camada de Consumo com uma instância externa do Cache do Azure para Redis como o cache externo do Gerenciamento de API.
site eShop com ILB ASE

Implantar no Azure
Um Ambiente do Serviço de Aplicativo é uma opção de plano de serviço Premium do Serviço de Aplicativo do Azure que fornece um ambiente totalmente isolado e dedicado para executar com segurança aplicativos do Serviço de Aplicativo do Azure em alta escala, incluindo Aplicativos Web, Aplicativos Móveis e Aplicativos de API.
Umbraco CMS Web App escalável

Implantar no Azure
Este modelo fornece uma maneira fácil de implantar o aplicativo Web UMBRACO CMS nos Aplicativos Web do Serviço de Aplicativo do Azure.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso Redis pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Cache/Redis, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Cache/Redis@2016-04-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"
      }
    }
  }
}

Valores de propriedade

Microsoft.Cache/Redis

Designação Descrição Valor
localização Localização do recurso. string (obrigatório)
Designação O nome do recurso string (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. string (obrigatório)
propriedades Propriedades do cache Redis. RedisCreatePropertiesOrRedisResourceProperties (obrigatório)
Etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.Cache/Redis@2016-04-01"

RedisCreatePropertiesOrRedisResourceProperties

Designação Descrição Valor
enableNonSslPort Especifica se a porta do servidor Redis não ssl (6379) está habilitada. Bool
redisConfiguration Todas as configurações do Redis. Poucas chaves possíveis: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta,maxmemory-policy,notify-keyspace-events,maxmemory-samples,slowlog-log-slower-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. RedisPropertiesRedisConfiguration
Contagem de fragmentos O número de fragmentos a serem criados em um Cache de Cluster Premium. Int
SKU O SKU do cache Redis a ser implantado. Sku (obrigatório)
estáticaIP Endereço IP estático. Necessário ao implantar um cache Redis dentro de uma Rede Virtual do Azure existente. cadeia de caracteres

Restrições:
Padrão = ^\d+\.\d+\.\d+\.\d+$
subnetId O ID de recurso completo de uma sub-rede em uma rede virtual para implantar o cache Redis. Formato de exemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Rede|ClassicNetwork}/VirtualNetworks/vnet1/sub-redes/sub-rede1 cadeia de caracteres

Restrições:
Padrão = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
configurações de locatário configurações de locatário RedisPropertiesTenantSettings

RedisPropertiesRedisConfiguration

Designação Descrição Valor

RedisPropertiesTenantSettings

Designação Descrição Valor

Tags de Recursos

Designação Descrição Valor

Referência

Designação Descrição Valor
capacidade O tamanho do cache Redis a ser implantado. Valores válidos: para a família C (Basic/Standard) (0, 1, 2, 3, 4, 5, 6), para a família P (Premium) (1, 2, 3, 4). int (obrigatório)
Família A família SKU a ser usada. Valores válidos: (C, P). (C = Básico/Padrão, P = Premium). «C»
'P' (obrigatório)
Designação O tipo de cache Redis a ser implantado. Valores válidos: (Básico, Standard, Premium) 'Básico'
'Premium'
'Standard' (obrigatório)

Exemplos de uso

Amostras Terraform

Um exemplo básico de implantação do Cache Redis.

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 verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Módulo Descrição
Cache Redis Módulo de recursos AVM para cache Redis