Redis do Microsoft.Cache

• última
• 2024-11-01
• 2024-04-01-prévia
• 2024-03-01
• 2023-08-01
• 2023-05-01-visualização
• 2023-04-01
• 2022-06-01
• 2022-05-01
• 2021-06-01
• 2020-12-01
• 2020-06-01
• 2019-07-01
• 2018-03-01
• 2017-10-01
• 2017-02-01
• 2016-04-01
• 2015-08-01

Definição de recurso do Bicep

O tipo de recurso redis pode ser implantado com operações direcionadas:

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

Formato de recurso

Para criar um recurso Microsoft.Cache/redis, adicione o Bicep a seguir ao seu modelo.

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 propriedade

Microsoft.Cache/redis

Nome	Descrição	Valor
identidade	A identidade do recurso.	ManagedServiceIdentity
local	A localização geográfica onde o recurso reside	cadeia de caracteres (obrigatório)
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Propriedades do cache Redis.	RedisCreatePropertiesOrRedisProperties (obrigatório)
escopo	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 .
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos
Zonas	Uma lista de zonas de disponibilidade indicando de onde o recurso precisa vir.	cadeia de caracteres[]

ManagedServiceIdentity

Nome	Descrição	Valor
tipo	Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).	'Nenhum' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' (obrigatório)
Identidades Atribuídas pelo Usuário	O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações.	UserAssignedIdentities

RedisCommonPropertiesRedisConfiguration

Nome	Descrição	Valor
habilitado para aad	Especifica se a autenticação baseada no AAD foi habilitada ou desabilitada para o cache	cadeia
habilitado para backup aof	Especifica se o backup de aof está habilitado	cadeia
cadeia de conexão de armazenamento aof 0	Primeira cadeia de conexão da conta de armazenamento	cadeia
cadeia de conexão de armazenamento aof 1	Cadeia de conexão da segunda conta de armazenamento	cadeia
authnotrequired	Especifica se a autenticação está desabilitada. Definir essa propriedade é altamente desencorajado do ponto de vista da segurança; Você nunca deve desabilitar a autenticação usando essa propriedade!	cadeia
maxfragmentationmemory-reserved	Valor em megabytes reservados para fragmentação por fragmento	cadeia
maxmemory-delta	Valor em megabytes reservados para uso não cache por fragmento, por exemplo, failover.	cadeia
maxmemory-policy	A estratégia de remoção usada quando seus dados não se ajustam ao limite de memória.	cadeia
memória máxima reservada	Valor em megabytes reservados para uso não cache por fragmento, por exemplo, failover.	cadeia
notify-keyspace-events	Os eventos de keyspace que devem ser monitorados.	cadeia
método de autenticação de persistência de dados preferido	Método de autenticação preferencial para se comunicar com a conta de armazenamento usada para persistência de dados, especificar SAS ou ManagedIdentity, o valor padrão é SAS	cadeia
rdb-backup habilitado	Especifica se o backup RDB está habilitado	cadeia
frequência de backup do RDB	Especifica a frequência para a criação de backup de rdb em minutos. Valores válidos: (15, 30, 60, 360, 720, 1440)	cadeia
rdb-backup-max-contagem de instantâneos	Especifica o número máximo de instantâneos para backup de rdb	cadeia
rdb-storage-connection-string	A cadeia de conexão da conta de armazenamento para armazenar o arquivo rdb	cadeia
ID de assinatura de armazenamento	SubscriptionId da conta de armazenamento para persistência (aof/rdb) usando ManagedIdentity.	cadeia

RedisCommonPropertiesTenantSettings

Nome	Descrição	Valor

RedisCreateParametersTags

Nome	Descrição	Valor

RedisCreatePropertiesOrRedisProperties

Nome	Descrição	Valor
disableAccessKeyAuthentication	A autenticação no Redis por meio de chaves de acesso é desabilitada quando definida como true. O valor padrão é falso.	Bool
enableNonSslPort	Especifica se a porta do servidor Redis não ssl (6379) está habilitada.	Bool
minimumTlsVersion	Opcional: exige que os clientes usem uma versão do TLS especificada (ou superior) para se conectar (por exemplo, '1.0', '1.1', '1.2')	'1.0' '1.1' '1.2'
públicoAcessoRedeAcesso	Se o acesso ao ponto de extremidade público é permitido ou não para esse cache. O valor é opcional, mas se passado, deve ser "Habilitado" ou "Desabilitado". Se 'Disabled', pontos de extremidade privados são o método de acesso exclusivo.	'Desabilitado' 'Habilitado'
redisConfiguração	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, aof-backup-enabled, aof-storage-connection-string-0, aof-storage-connection-string-1 etc.	RedisCommonPropertiesRedisConfiguration
redisVersion	Versão do Redis. Isso deve estar na forma 'major[.minor]' (apenas 'major' é necessário) ou o valor 'latest' que se refere à versão mais recente estável do Redis que está disponível. Versões com suporte: 4.0, 6.0 (mais recente). O valor padrão é 'mais recente'.	cadeia
réplicasPerMaster	O número de réplicas a serem criadas por primário.	int
replicasPerPrimary	O número de réplicas a serem criadas por primário.	int
contagem de fragmentos	O número de fragmentos a serem criados em um Cache de Cluster Premium.	int
Sku	A SKU do cache Redis a ser implantada.	de SKU (obrigatório)
IP estático	Endereço IP estático. Opcionalmente, pode ser especificado ao implantar um cache Redis dentro de uma Rede Virtual do Azure existente; atribuído automaticamente por padrão.	corda Restrições: Padrão = ^\d+\.\d+\.\d+\.\d+$
ID da sub-rede	A ID de recurso completa 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/subnets/subnet1	corda Restrições: Padrão = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
Configurações de inquilino	Um dicionário de configurações de locatário	RedisCommonPropertiesTenantSettings
updateChannel	Opcional: especifica o canal de atualização para as atualizações mensais do Redis que o Cache Redis receberá. Os caches que usam o canal de atualização 'Visualização' recebem atualizações mais recentes do Redis pelo menos 4 semanas antes dos caches de canal 'Estável'. O valor padrão é 'Estável'.	'Versão prévia' 'Estável'
zonalAllocationPolicy	Opcional: especifica como as zonas de disponibilidade são alocadas para o cache Redis. O 'Automático' habilita a redundância de zona e o Azure selecionará automaticamente zonas com base na disponibilidade e na capacidade regionais. 'UserDefined' selecionará zonas de disponibilidade passadas por você usando o parâmetro 'zones'. 'NoZones' produzirá um cache não zonal. Se 'zonalAllocationPolicy' não for passado, ele será definido como 'UserDefined' quando as zonas forem passadas, caso contrário, ele será definido como 'Automático' em regiões em que há suporte para zonas e 'NoZones' em regiões em que as zonas não têm suporte.	'Automático' 'Sem Zonas' 'Definido pelo usuário'

Sku

Nome	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/Standard, P = Premium).	'C' 'P' (obrigatório)
nome	O tipo de cache Redis a ser implantado. Valores válidos: (Basic, Standard, Premium)	'Básico' 'Prêmio' 'Standard' (obrigatório)

UserAssignedIdentities

Nome	Descrição	Valor

UserAssignedIdentity

Nome	Descrição	Valor

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo	Descrição
do Cache Redis	Módulo de recurso AVM para Cache Redis

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep	Descrição
Criar um Cache Redis Premium com de 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	Esse 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. Em seguida, atribui a política de acesso personalizado a outro usuário do Redis.
criar um aplicativo Web mais o Cache Redis usando um modelo	Esse modelo cria um aplicativo Web do Azure com o 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 de 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 do ARM

O tipo de recurso redis pode ser implantado com operações direcionadas:

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

Formato de recurso

Para criar um recurso Microsoft.Cache/redis, adicione o JSON a seguir ao seu modelo.

{
  "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 propriedade

Microsoft.Cache/redis

Nome	Descrição	Valor
apiVersion	A versão da API	'2024-11-01'
identidade	A identidade do recurso.	ManagedServiceIdentity
local	A localização geográfica onde o recurso reside	cadeia de caracteres (obrigatório)
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Propriedades do cache Redis.	RedisCreatePropertiesOrRedisProperties (obrigatório)
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo	O tipo de recurso	'Microsoft.Cache/redis'
Zonas	Uma lista de zonas de disponibilidade indicando de onde o recurso precisa vir.	cadeia de caracteres[]

ManagedServiceIdentity

Nome	Descrição	Valor
tipo	Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).	'Nenhum' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' (obrigatório)
Identidades Atribuídas pelo Usuário	O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações.	UserAssignedIdentities

RedisCommonPropertiesRedisConfiguration

Nome	Descrição	Valor
habilitado para aad	Especifica se a autenticação baseada no AAD foi habilitada ou desabilitada para o cache	cadeia
habilitado para backup aof	Especifica se o backup de aof está habilitado	cadeia
cadeia de conexão de armazenamento aof 0	Primeira cadeia de conexão da conta de armazenamento	cadeia
cadeia de conexão de armazenamento aof 1	Cadeia de conexão da segunda conta de armazenamento	cadeia
authnotrequired	Especifica se a autenticação está desabilitada. Definir essa propriedade é altamente desencorajado do ponto de vista da segurança; Você nunca deve desabilitar a autenticação usando essa propriedade!	cadeia
maxfragmentationmemory-reserved	Valor em megabytes reservados para fragmentação por fragmento	cadeia
maxmemory-delta	Valor em megabytes reservados para uso não cache por fragmento, por exemplo, failover.	cadeia
maxmemory-policy	A estratégia de remoção usada quando seus dados não se ajustam ao limite de memória.	cadeia
memória máxima reservada	Valor em megabytes reservados para uso não cache por fragmento, por exemplo, failover.	cadeia
notify-keyspace-events	Os eventos de keyspace que devem ser monitorados.	cadeia
método de autenticação de persistência de dados preferido	Método de autenticação preferencial para se comunicar com a conta de armazenamento usada para persistência de dados, especificar SAS ou ManagedIdentity, o valor padrão é SAS	cadeia
rdb-backup habilitado	Especifica se o backup RDB está habilitado	cadeia
frequência de backup do RDB	Especifica a frequência para a criação de backup de rdb em minutos. Valores válidos: (15, 30, 60, 360, 720, 1440)	cadeia
rdb-backup-max-contagem de instantâneos	Especifica o número máximo de instantâneos para backup de rdb	cadeia
rdb-storage-connection-string	A cadeia de conexão da conta de armazenamento para armazenar o arquivo rdb	cadeia
ID de assinatura de armazenamento	SubscriptionId da conta de armazenamento para persistência (aof/rdb) usando ManagedIdentity.	cadeia

RedisCommonPropertiesTenantSettings

Nome	Descrição	Valor

RedisCreateParametersTags

Nome	Descrição	Valor

RedisCreatePropertiesOrRedisProperties

Nome	Descrição	Valor
disableAccessKeyAuthentication	A autenticação no Redis por meio de chaves de acesso é desabilitada quando definida como true. O valor padrão é falso.	Bool
enableNonSslPort	Especifica se a porta do servidor Redis não ssl (6379) está habilitada.	Bool
minimumTlsVersion	Opcional: exige que os clientes usem uma versão do TLS especificada (ou superior) para se conectar (por exemplo, '1.0', '1.1', '1.2')	'1.0' '1.1' '1.2'
públicoAcessoRedeAcesso	Se o acesso ao ponto de extremidade público é permitido ou não para esse cache. O valor é opcional, mas se passado, deve ser "Habilitado" ou "Desabilitado". Se 'Disabled', pontos de extremidade privados são o método de acesso exclusivo.	'Desabilitado' 'Habilitado'
redisConfiguração	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, aof-backup-enabled, aof-storage-connection-string-0, aof-storage-connection-string-1 etc.	RedisCommonPropertiesRedisConfiguration
redisVersion	Versão do Redis. Isso deve estar na forma 'major[.minor]' (apenas 'major' é necessário) ou o valor 'latest' que se refere à versão mais recente estável do Redis que está disponível. Versões com suporte: 4.0, 6.0 (mais recente). O valor padrão é 'mais recente'.	cadeia
réplicasPerMaster	O número de réplicas a serem criadas por primário.	int
replicasPerPrimary	O número de réplicas a serem criadas por primário.	int
contagem de fragmentos	O número de fragmentos a serem criados em um Cache de Cluster Premium.	int
Sku	A SKU do cache Redis a ser implantada.	de SKU (obrigatório)
IP estático	Endereço IP estático. Opcionalmente, pode ser especificado ao implantar um cache Redis dentro de uma Rede Virtual do Azure existente; atribuído automaticamente por padrão.	corda Restrições: Padrão = ^\d+\.\d+\.\d+\.\d+$
ID da sub-rede	A ID de recurso completa 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/subnets/subnet1	corda Restrições: Padrão = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
Configurações de inquilino	Um dicionário de configurações de locatário	RedisCommonPropertiesTenantSettings
updateChannel	Opcional: especifica o canal de atualização para as atualizações mensais do Redis que o Cache Redis receberá. Os caches que usam o canal de atualização 'Visualização' recebem atualizações mais recentes do Redis pelo menos 4 semanas antes dos caches de canal 'Estável'. O valor padrão é 'Estável'.	'Versão prévia' 'Estável'
zonalAllocationPolicy	Opcional: especifica como as zonas de disponibilidade são alocadas para o cache Redis. O 'Automático' habilita a redundância de zona e o Azure selecionará automaticamente zonas com base na disponibilidade e na capacidade regionais. 'UserDefined' selecionará zonas de disponibilidade passadas por você usando o parâmetro 'zones'. 'NoZones' produzirá um cache não zonal. Se 'zonalAllocationPolicy' não for passado, ele será definido como 'UserDefined' quando as zonas forem passadas, caso contrário, ele será definido como 'Automático' em regiões em que há suporte para zonas e 'NoZones' em regiões em que as zonas não têm suporte.	'Automático' 'Sem Zonas' 'Definido pelo usuário'

Sku

Nome	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/Standard, P = Premium).	'C' 'P' (obrigatório)
nome	O tipo de cache Redis a ser implantado. Valores válidos: (Basic, Standard, Premium)	'Básico' 'Prêmio' 'Standard' (obrigatório)

UserAssignedIdentities

Nome	Descrição	Valor

UserAssignedIdentity

Nome	Descrição	Valor

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Modelo	Descrição
Criar um Cache Redis Premium com de 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	Esse 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. Em seguida, atribui a política de acesso personalizado a outro usuário do Redis.
Criar um Aplicativo Web + Cache Redis + Banco de Dados SQL com um modelo	Esse modelo cria um Aplicativo Web do Azure com o cache Redis e um Banco de Dados SQL.
criar um aplicativo Web mais o Cache Redis usando um modelo	Esse modelo cria um aplicativo Web do Azure com o 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 de persistência de dados	Este modelo mostra como configurar a persistência em uma instância premium do Cache Redis do Azure.
Criar dois caches replicados geograficamente em um de Rede Virtual	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	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 do eShop com ase do ILB	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.
aplicativo Web Umbraco CMS escalonável	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 recurso do Terraform (provedor de AzAPI)

O tipo de recurso redis pode ser implantado com operações direcionadas:

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

Formato de recurso

Para criar um recurso Microsoft.Cache/redis, adicione o Terraform a seguir ao seu modelo.

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 propriedade

Microsoft.Cache/redis

Nome	Descrição	Valor
identidade	A identidade do recurso.	ManagedServiceIdentity
local	A localização geográfica onde o recurso reside	cadeia de caracteres (obrigatório)
nome	O nome do recurso	cadeia de caracteres (obrigatório)
parent_id	A ID do recurso ao qual aplicar esse recurso de extensão.	cadeia de caracteres (obrigatório)
Propriedades	Propriedades do cache Redis.	RedisCreatePropertiesOrRedisProperties (obrigatório)
Tags	Marcas de recurso	Dicionário de nomes e valores de marca.
tipo	O tipo de recurso	"Microsoft.Cache/redis@2024-11-01"
Zonas	Uma lista de zonas de disponibilidade indicando de onde o recurso precisa vir.	cadeia de caracteres[]

ManagedServiceIdentity

Nome	Descrição	Valor
tipo	Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).	'Nenhum' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' (obrigatório)
Identidades Atribuídas pelo Usuário	O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações.	UserAssignedIdentities

RedisCommonPropertiesRedisConfiguration

Nome	Descrição	Valor
habilitado para aad	Especifica se a autenticação baseada no AAD foi habilitada ou desabilitada para o cache	cadeia
habilitado para backup aof	Especifica se o backup de aof está habilitado	cadeia
cadeia de conexão de armazenamento aof 0	Primeira cadeia de conexão da conta de armazenamento	cadeia
cadeia de conexão de armazenamento aof 1	Cadeia de conexão da segunda conta de armazenamento	cadeia
authnotrequired	Especifica se a autenticação está desabilitada. Definir essa propriedade é altamente desencorajado do ponto de vista da segurança; Você nunca deve desabilitar a autenticação usando essa propriedade!	cadeia
maxfragmentationmemory-reserved	Valor em megabytes reservados para fragmentação por fragmento	cadeia
maxmemory-delta	Valor em megabytes reservados para uso não cache por fragmento, por exemplo, failover.	cadeia
maxmemory-policy	A estratégia de remoção usada quando seus dados não se ajustam ao limite de memória.	cadeia
memória máxima reservada	Valor em megabytes reservados para uso não cache por fragmento, por exemplo, failover.	cadeia
notify-keyspace-events	Os eventos de keyspace que devem ser monitorados.	cadeia
método de autenticação de persistência de dados preferido	Método de autenticação preferencial para se comunicar com a conta de armazenamento usada para persistência de dados, especificar SAS ou ManagedIdentity, o valor padrão é SAS	cadeia
rdb-backup habilitado	Especifica se o backup RDB está habilitado	cadeia
frequência de backup do RDB	Especifica a frequência para a criação de backup de rdb em minutos. Valores válidos: (15, 30, 60, 360, 720, 1440)	cadeia
rdb-backup-max-contagem de instantâneos	Especifica o número máximo de instantâneos para backup de rdb	cadeia
rdb-storage-connection-string	A cadeia de conexão da conta de armazenamento para armazenar o arquivo rdb	cadeia
ID de assinatura de armazenamento	SubscriptionId da conta de armazenamento para persistência (aof/rdb) usando ManagedIdentity.	cadeia

RedisCommonPropertiesTenantSettings

Nome	Descrição	Valor

RedisCreateParametersTags

Nome	Descrição	Valor

RedisCreatePropertiesOrRedisProperties

Nome	Descrição	Valor
disableAccessKeyAuthentication	A autenticação no Redis por meio de chaves de acesso é desabilitada quando definida como true. O valor padrão é falso.	Bool
enableNonSslPort	Especifica se a porta do servidor Redis não ssl (6379) está habilitada.	Bool
minimumTlsVersion	Opcional: exige que os clientes usem uma versão do TLS especificada (ou superior) para se conectar (por exemplo, '1.0', '1.1', '1.2')	'1.0' '1.1' '1.2'
públicoAcessoRedeAcesso	Se o acesso ao ponto de extremidade público é permitido ou não para esse cache. O valor é opcional, mas se passado, deve ser "Habilitado" ou "Desabilitado". Se 'Disabled', pontos de extremidade privados são o método de acesso exclusivo.	'Desabilitado' 'Habilitado'
redisConfiguração	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, aof-backup-enabled, aof-storage-connection-string-0, aof-storage-connection-string-1 etc.	RedisCommonPropertiesRedisConfiguration
redisVersion	Versão do Redis. Isso deve estar na forma 'major[.minor]' (apenas 'major' é necessário) ou o valor 'latest' que se refere à versão mais recente estável do Redis que está disponível. Versões com suporte: 4.0, 6.0 (mais recente). O valor padrão é 'mais recente'.	cadeia
réplicasPerMaster	O número de réplicas a serem criadas por primário.	int
replicasPerPrimary	O número de réplicas a serem criadas por primário.	int
contagem de fragmentos	O número de fragmentos a serem criados em um Cache de Cluster Premium.	int
Sku	A SKU do cache Redis a ser implantada.	de SKU (obrigatório)
IP estático	Endereço IP estático. Opcionalmente, pode ser especificado ao implantar um cache Redis dentro de uma Rede Virtual do Azure existente; atribuído automaticamente por padrão.	corda Restrições: Padrão = ^\d+\.\d+\.\d+\.\d+$
ID da sub-rede	A ID de recurso completa 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/subnets/subnet1	corda Restrições: Padrão = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
Configurações de inquilino	Um dicionário de configurações de locatário	RedisCommonPropertiesTenantSettings
updateChannel	Opcional: especifica o canal de atualização para as atualizações mensais do Redis que o Cache Redis receberá. Os caches que usam o canal de atualização 'Visualização' recebem atualizações mais recentes do Redis pelo menos 4 semanas antes dos caches de canal 'Estável'. O valor padrão é 'Estável'.	'Versão prévia' 'Estável'
zonalAllocationPolicy	Opcional: especifica como as zonas de disponibilidade são alocadas para o cache Redis. O 'Automático' habilita a redundância de zona e o Azure selecionará automaticamente zonas com base na disponibilidade e na capacidade regionais. 'UserDefined' selecionará zonas de disponibilidade passadas por você usando o parâmetro 'zones'. 'NoZones' produzirá um cache não zonal. Se 'zonalAllocationPolicy' não for passado, ele será definido como 'UserDefined' quando as zonas forem passadas, caso contrário, ele será definido como 'Automático' em regiões em que há suporte para zonas e 'NoZones' em regiões em que as zonas não têm suporte.	'Automático' 'Sem Zonas' 'Definido pelo usuário'

Sku

Nome	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/Standard, P = Premium).	'C' 'P' (obrigatório)
nome	O tipo de cache Redis a ser implantado. Valores válidos: (Basic, Standard, Premium)	'Básico' 'Prêmio' 'Standard' (obrigatório)

UserAssignedIdentities

Nome	Descrição	Valor

UserAssignedIdentity

Nome	Descrição	Valor

Exemplos de uso

Exemplos do 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

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo	Descrição
do Cache Redis	Módulo de recurso AVM para Cache Redis