Partager via


Redis Microsoft.Cache

Définition de ressource Bicep

Le type de ressource redis peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Cache/redis, ajoutez le bicep suivant à votre modèle.

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'
  ]
}

Valeurs de propriété

Microsoft.Cache/redis

Nom Descriptif Valeur
identité Identité de la ressource. ManagedServiceIdentity
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés du cache Redis. RedisCreatePropertiesOrRedisProperties (obligatoire)
portée Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension .
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
Zones Liste des zones de disponibilité indiquant à partir de laquelle la ressource doit provenir. chaîne[]

Identité de Service Gérée (ManagedServiceIdentity)

Nom Descriptif Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). « Aucun »
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatoire)
Identités attribuées par l'utilisateur Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

RedisCommonPropertiesRedisConfiguration

Nom Descriptif Valeur
Compatible AAD Spécifie si l’authentification basée sur AAD a été activée ou désactivée pour le cache corde
aof-backup-enabled Spécifie si la sauvegarde aof est activée corde
chaîne-de-connexion-de-stockage-aof-0 Première chaîne de connexion de compte de stockage corde
chaîne-de-connexion-de-stockage-aof-1 Deuxième chaîne de connexion de compte de stockage corde
authnotrequired Spécifie si l’authentification est désactivée. L’établissement de cette propriété est fortement déconseillé du point de vue de la sécurité ; Vous ne devez jamais désactiver l’authentification à l’aide de cette propriété ! corde
maxfragmentationréservé à la mémoire Valeur en mégaoctets réservés pour la fragmentation par partition corde
maxmemory-delta Valeur en mégaoctets réservés pour l’utilisation non du cache par partition, par exemple le basculement. corde
politique de mémoire maximale La stratégie d’éviction utilisée lorsque vos données ne correspondent pas à sa limite de mémoire. corde
maxmemory-réservé Valeur en mégaoctets réservés pour l’utilisation non du cache par partition, par exemple le basculement. corde
notify-keyspace-events Événements d’espace de clés qui doivent être surveillés. corde
méthode-d’authentification-de-persistance-de-donnees-preferred- Méthode d’authentification préférée pour communiquer avec le compte de stockage utilisé pour la persistance des données, spécifier saS ou ManagedIdentity, la valeur par défaut est SAS corde
rdb-backup-enabled Spécifie si la sauvegarde RDB est activée corde
fréquence de sauvegarde RDB Spécifie la fréquence de création d’une sauvegarde rdb en minutes. Valeurs valides : (15, 30, 60, 360, 720, 1440) corde
rdb-backup-max-snapshot-count Spécifie le nombre maximal d’instantanés pour la sauvegarde rdb corde
rdb-storage-connection-string Chaîne de connexion de compte de stockage pour le stockage du fichier rdb corde
id_abonnement-stockage SubscriptionId du compte de stockage pour la persistance (aof/rdb) à l’aide de ManagedIdentity. corde

RedisCommonPropertiesTenantSettings

Nom Descriptif Valeur

RedisCreateParametersTags

Nom Descriptif Valeur

RedisCreatePropertiesOrRedisProperties

Nom Descriptif Valeur
disableAccessKeyAuthentication L’authentification auprès de Redis par le biais de clés d’accès est désactivée lorsqu’elle est définie sur true. La valeur par défaut est false. Bool
enableNonSslPort Spécifie si le port du serveur Redis non ssl (6379) est activé. Bool
minimumTlsVersion Facultatif : nécessite que les clients utilisent une version TLS spécifiée (ou une version ultérieure) pour se connecter (par exemple, « 1.0 », « 1.1 », « 1.2 ») '1.0'
'1.1'
'1.2'
publicNetworkAccess Indique si l’accès au point de terminaison public est autorisé pour ce cache. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé ». Si « Désactivé », les points de terminaison privés sont la méthode d’accès exclusif. 'Désactivé'
'Activé'
redisConfiguration Tous les paramètres Redis. Peu de clés possibles : 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-string-1, etc. RedisCommonPropertiesRedisConfiguration
redisVersion Version de Redis. Il doit s’agir de la forme « major[.minor] » (seul « major » est requis) ou de la valeur « latest » qui fait référence à la dernière version stable de Redis disponible. Versions prises en charge : 4.0, 6.0 (dernière version). La valeur par défaut est « latest ». corde
répliquesPerMaster Nombre de réplicas à créer par réplica principal. Int
réplicasPerPrimary Nombre de réplicas à créer par réplica principal. Int
shardCount Nombre de partitions à créer sur un cache de cluster Premium. Int
Sku Référence SKU du cache Redis à déployer. référence SKU (obligatoire)
staticIP Adresse IP statique. Si vous le souhaitez, vous pouvez spécifier le déploiement d’un cache Redis à l’intérieur d’un réseau virtuel Azure existant ; automatiquement affecté par défaut. corde

Contraintes:
Modèle = ^\d+\.\d+\.\d+\.\d+$
subnetId ID de ressource complet d’un sous-réseau dans un réseau virtuel dans lequel déployer le cache Redis. Exemple de format : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Network|ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1 corde

Contraintes:
Modèle = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
tenantSettings Dictionnaire des paramètres de locataire RedisCommonPropertiesTenantSettings
updateChannel Facultatif : spécifie le canal de mise à jour pour les mises à jour mensuelles de Redis que votre cache Redis recevra. Les caches utilisant le canal de mise à jour « Préversion » obtiennent les dernières mises à jour Redis au moins 4 semaines à l’avance sur les caches de canal « Stable ». La valeur par défaut est « Stable ». 'Avant-première'
'Stable'
zonalAllocationPolicy Facultatif : spécifie la façon dont les zones de disponibilité sont allouées au cache Redis. « Automatique » active la redondance de zone et Azure sélectionne automatiquement les zones en fonction de la disponibilité et de la capacité régionales. « UserDefined » sélectionne les zones de disponibilité transmises par vous à l’aide du paramètre « zones ». 'NoZones' produit un cache non zonal. Si « zonalAllocationPolicy » n’est pas passé, il est défini sur « UserDefined » lorsque les zones sont passées ; sinon, elle est définie sur « Automatique » dans les régions où les zones sont prises en charge et « NoZones » dans les régions où les zones ne sont pas prises en charge. 'Automatique'
'NoZones'
'Défini par l’utilisateur'

Sku

Nom Descriptif Valeur
capacité Taille du cache Redis à déployer. Valeurs valides : pour la famille C (De base/Standard) (0, 1, 2, 3, 4, 5, 6), pour la famille P (Premium) (1, 2, 3, 4). int (obligatoire)
Famille Famille de références SKU à utiliser. Valeurs valides : (C, P). (C = De base/Standard, P = Premium). 'C'
'P' (obligatoire)
nom Type de cache Redis à déployer. Valeurs valides : (De base, Standard, Premium) 'De base'
« Haut de gamme »
'Standard' (obligatoire)

UserAssignedIdentities

Nom Descriptif Valeur

userAssignedIdentity

Nom Descriptif Valeur

Exemples d’utilisation

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Descriptif
cache Redis Module de ressources AVM pour le cache Redis

Exemples de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.

Fichier Bicep Descriptif
Créer un cache Redis Premium avec de clustering Ce modèle montre comment configurer le clustering dans une instance de cache Redis Azure Premium.
Créer un cache Redis à l’aide d’un modèle Ce modèle crée un cache Redis Azure avec des données de diagnostic conservées dans un compte de stockage.
Créer un cache Redis avec l’authentification Microsoft Entra. Ce modèle crée un cache Redis. Attribue ensuite une stratégie d’accès intégrée à un utilisateur redis. Crée ensuite une stratégie d’accès personnalisée. Ensuite, affectez la stratégie d’accès personnalisée à un autre utilisateur Redis.
Créer une application web plus le cache Redis à l’aide d’un modèle Ce modèle crée une application web Azure avec le cache Redis.
créer un cache Redis Premium déployé dans un de réseau virtuel Ce modèle montre comment déployer une instance de cache Redis Azure Premium dans un réseau virtuel existant
Créer un cache Redis Premium avec persistance des données Ce modèle montre comment configurer la persistance dans une instance de cache Redis Azure Premium.
Déployer la gestion des API avec un cache Azure externe pour Redis Ce modèle montre comment créer une instance de Gestion des API Azure dans le niveau Consommation avec une instance Azure Cache pour Redis externe en tant que cache externe gestion des API.

Définition de ressource de modèle ARM

Le type de ressource redis peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Cache/redis, ajoutez le code JSON suivant à votre modèle.

{
  "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" ]
}

Valeurs de propriété

Microsoft.Cache/redis

Nom Descriptif Valeur
apiVersion Version de l’API '2024-11-01'
identité Identité de la ressource. ManagedServiceIdentity
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés du cache Redis. RedisCreatePropertiesOrRedisProperties (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.Cache/redis'
Zones Liste des zones de disponibilité indiquant à partir de laquelle la ressource doit provenir. chaîne[]

Identité de Service Gérée (ManagedServiceIdentity)

Nom Descriptif Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). « Aucun »
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatoire)
Identités attribuées par l'utilisateur Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

RedisCommonPropertiesRedisConfiguration

Nom Descriptif Valeur
Compatible AAD Spécifie si l’authentification basée sur AAD a été activée ou désactivée pour le cache corde
aof-backup-enabled Spécifie si la sauvegarde aof est activée corde
chaîne-de-connexion-de-stockage-aof-0 Première chaîne de connexion de compte de stockage corde
chaîne-de-connexion-de-stockage-aof-1 Deuxième chaîne de connexion de compte de stockage corde
authnotrequired Spécifie si l’authentification est désactivée. L’établissement de cette propriété est fortement déconseillé du point de vue de la sécurité ; Vous ne devez jamais désactiver l’authentification à l’aide de cette propriété ! corde
maxfragmentationréservé à la mémoire Valeur en mégaoctets réservés pour la fragmentation par partition corde
maxmemory-delta Valeur en mégaoctets réservés pour l’utilisation non du cache par partition, par exemple le basculement. corde
politique de mémoire maximale La stratégie d’éviction utilisée lorsque vos données ne correspondent pas à sa limite de mémoire. corde
maxmemory-réservé Valeur en mégaoctets réservés pour l’utilisation non du cache par partition, par exemple le basculement. corde
notify-keyspace-events Événements d’espace de clés qui doivent être surveillés. corde
méthode-d’authentification-de-persistance-de-donnees-preferred- Méthode d’authentification préférée pour communiquer avec le compte de stockage utilisé pour la persistance des données, spécifier saS ou ManagedIdentity, la valeur par défaut est SAS corde
rdb-backup-enabled Spécifie si la sauvegarde RDB est activée corde
fréquence de sauvegarde RDB Spécifie la fréquence de création d’une sauvegarde rdb en minutes. Valeurs valides : (15, 30, 60, 360, 720, 1440) corde
rdb-backup-max-snapshot-count Spécifie le nombre maximal d’instantanés pour la sauvegarde rdb corde
rdb-storage-connection-string Chaîne de connexion de compte de stockage pour le stockage du fichier rdb corde
id_abonnement-stockage SubscriptionId du compte de stockage pour la persistance (aof/rdb) à l’aide de ManagedIdentity. corde

RedisCommonPropertiesTenantSettings

Nom Descriptif Valeur

RedisCreateParametersTags

Nom Descriptif Valeur

RedisCreatePropertiesOrRedisProperties

Nom Descriptif Valeur
disableAccessKeyAuthentication L’authentification auprès de Redis par le biais de clés d’accès est désactivée lorsqu’elle est définie sur true. La valeur par défaut est false. Bool
enableNonSslPort Spécifie si le port du serveur Redis non ssl (6379) est activé. Bool
minimumTlsVersion Facultatif : nécessite que les clients utilisent une version TLS spécifiée (ou une version ultérieure) pour se connecter (par exemple, « 1.0 », « 1.1 », « 1.2 ») '1.0'
'1.1'
'1.2'
publicNetworkAccess Indique si l’accès au point de terminaison public est autorisé pour ce cache. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé ». Si « Désactivé », les points de terminaison privés sont la méthode d’accès exclusif. 'Désactivé'
'Activé'
redisConfiguration Tous les paramètres Redis. Peu de clés possibles : 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-string-1, etc. RedisCommonPropertiesRedisConfiguration
redisVersion Version de Redis. Il doit s’agir de la forme « major[.minor] » (seul « major » est requis) ou de la valeur « latest » qui fait référence à la dernière version stable de Redis disponible. Versions prises en charge : 4.0, 6.0 (dernière version). La valeur par défaut est « latest ». corde
répliquesPerMaster Nombre de réplicas à créer par réplica principal. Int
réplicasPerPrimary Nombre de réplicas à créer par réplica principal. Int
shardCount Nombre de partitions à créer sur un cache de cluster Premium. Int
Sku Référence SKU du cache Redis à déployer. référence SKU (obligatoire)
staticIP Adresse IP statique. Si vous le souhaitez, vous pouvez spécifier le déploiement d’un cache Redis à l’intérieur d’un réseau virtuel Azure existant ; automatiquement affecté par défaut. corde

Contraintes:
Modèle = ^\d+\.\d+\.\d+\.\d+$
subnetId ID de ressource complet d’un sous-réseau dans un réseau virtuel dans lequel déployer le cache Redis. Exemple de format : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Network|ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1 corde

Contraintes:
Modèle = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
tenantSettings Dictionnaire des paramètres de locataire RedisCommonPropertiesTenantSettings
updateChannel Facultatif : spécifie le canal de mise à jour pour les mises à jour mensuelles de Redis que votre cache Redis recevra. Les caches utilisant le canal de mise à jour « Préversion » obtiennent les dernières mises à jour Redis au moins 4 semaines à l’avance sur les caches de canal « Stable ». La valeur par défaut est « Stable ». 'Avant-première'
'Stable'
zonalAllocationPolicy Facultatif : spécifie la façon dont les zones de disponibilité sont allouées au cache Redis. « Automatique » active la redondance de zone et Azure sélectionne automatiquement les zones en fonction de la disponibilité et de la capacité régionales. « UserDefined » sélectionne les zones de disponibilité transmises par vous à l’aide du paramètre « zones ». 'NoZones' produit un cache non zonal. Si « zonalAllocationPolicy » n’est pas passé, il est défini sur « UserDefined » lorsque les zones sont passées ; sinon, elle est définie sur « Automatique » dans les régions où les zones sont prises en charge et « NoZones » dans les régions où les zones ne sont pas prises en charge. 'Automatique'
'NoZones'
'Défini par l’utilisateur'

Sku

Nom Descriptif Valeur
capacité Taille du cache Redis à déployer. Valeurs valides : pour la famille C (De base/Standard) (0, 1, 2, 3, 4, 5, 6), pour la famille P (Premium) (1, 2, 3, 4). int (obligatoire)
Famille Famille de références SKU à utiliser. Valeurs valides : (C, P). (C = De base/Standard, P = Premium). 'C'
'P' (obligatoire)
nom Type de cache Redis à déployer. Valeurs valides : (De base, Standard, Premium) 'De base'
« Haut de gamme »
'Standard' (obligatoire)

UserAssignedIdentities

Nom Descriptif Valeur

userAssignedIdentity

Nom Descriptif Valeur

Exemples d’utilisation

Modèles de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.

Modèle Descriptif
Créer un cache Redis Premium avec de clustering

Déployer sur Azure
Ce modèle montre comment configurer le clustering dans une instance de cache Redis Azure Premium.
Créer un cache Redis à l’aide d’un modèle

Déployer sur Azure
Ce modèle crée un cache Redis Azure avec des données de diagnostic conservées dans un compte de stockage.
Créer un cache Redis avec l’authentification Microsoft Entra.

Déployer sur Azure
Ce modèle crée un cache Redis. Attribue ensuite une stratégie d’accès intégrée à un utilisateur redis. Crée ensuite une stratégie d’accès personnalisée. Ensuite, affectez la stratégie d’accès personnalisée à un autre utilisateur Redis.
Créer une application web + Cache Redis + BASE de données SQL avec un modèle

Déployer sur Azure
Ce modèle crée une application web Azure avec le cache Redis et une base de données SQL.
Créer une application web plus le cache Redis à l’aide d’un modèle

Déployer sur Azure
Ce modèle crée une application web Azure avec le cache Redis.
créer un cache Redis Premium déployé dans un de réseau virtuel

Déployer sur Azure
Ce modèle montre comment déployer une instance de cache Redis Azure Premium dans un réseau virtuel existant
Créer un cache Redis Premium avec persistance des données

Déployer sur Azure
Ce modèle montre comment configurer la persistance dans une instance de cache Redis Azure Premium.
Créer deux caches géorépliqués dans un de réseau virtuel

Déployer sur Azure
Ce modèle montre comment déployer deux instances Azure Cache pour Redis de niveau Premium dans des réseaux virtuels distincts et les lier à la géoréplication.
Déployer la gestion des API avec un cache Azure externe pour Redis

Déployer sur Azure
Ce modèle montre comment créer une instance de Gestion des API Azure dans le niveau Consommation avec une instance Azure Cache pour Redis externe en tant que cache externe gestion des API.
site web eShop avec ILB ASE

Déployer sur Azure
Un environnement App Service est une option de plan de service Premium d’Azure App Service qui fournit un environnement entièrement isolé et dédié pour exécuter en toute sécurité des applications Azure App Service à grande échelle, notamment Web Apps, Mobile Apps et API Apps.
application web Umbraco CMS scalable

Déployer sur Azure
Ce modèle offre un moyen simple de déployer une application web umbraco CMS sur Azure App Service Web Apps.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource redis peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Cache/redis, ajoutez la terraform suivante à votre modèle.

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"
    ]
  }
}

Valeurs de propriété

Microsoft.Cache/redis

Nom Descriptif Valeur
identité Identité de la ressource. ManagedServiceIdentity
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
Propriétés Propriétés du cache Redis. RedisCreatePropertiesOrRedisProperties (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.Cache/redis@2024-11-01 »
Zones Liste des zones de disponibilité indiquant à partir de laquelle la ressource doit provenir. chaîne[]

Identité de Service Gérée (ManagedServiceIdentity)

Nom Descriptif Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). « Aucun »
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatoire)
Identités attribuées par l'utilisateur Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

RedisCommonPropertiesRedisConfiguration

Nom Descriptif Valeur
Compatible AAD Spécifie si l’authentification basée sur AAD a été activée ou désactivée pour le cache corde
aof-backup-enabled Spécifie si la sauvegarde aof est activée corde
chaîne-de-connexion-de-stockage-aof-0 Première chaîne de connexion de compte de stockage corde
chaîne-de-connexion-de-stockage-aof-1 Deuxième chaîne de connexion de compte de stockage corde
authnotrequired Spécifie si l’authentification est désactivée. L’établissement de cette propriété est fortement déconseillé du point de vue de la sécurité ; Vous ne devez jamais désactiver l’authentification à l’aide de cette propriété ! corde
maxfragmentationréservé à la mémoire Valeur en mégaoctets réservés pour la fragmentation par partition corde
maxmemory-delta Valeur en mégaoctets réservés pour l’utilisation non du cache par partition, par exemple le basculement. corde
politique de mémoire maximale La stratégie d’éviction utilisée lorsque vos données ne correspondent pas à sa limite de mémoire. corde
maxmemory-réservé Valeur en mégaoctets réservés pour l’utilisation non du cache par partition, par exemple le basculement. corde
notify-keyspace-events Événements d’espace de clés qui doivent être surveillés. corde
méthode-d’authentification-de-persistance-de-donnees-preferred- Méthode d’authentification préférée pour communiquer avec le compte de stockage utilisé pour la persistance des données, spécifier saS ou ManagedIdentity, la valeur par défaut est SAS corde
rdb-backup-enabled Spécifie si la sauvegarde RDB est activée corde
fréquence de sauvegarde RDB Spécifie la fréquence de création d’une sauvegarde rdb en minutes. Valeurs valides : (15, 30, 60, 360, 720, 1440) corde
rdb-backup-max-snapshot-count Spécifie le nombre maximal d’instantanés pour la sauvegarde rdb corde
rdb-storage-connection-string Chaîne de connexion de compte de stockage pour le stockage du fichier rdb corde
id_abonnement-stockage SubscriptionId du compte de stockage pour la persistance (aof/rdb) à l’aide de ManagedIdentity. corde

RedisCommonPropertiesTenantSettings

Nom Descriptif Valeur

RedisCreateParametersTags

Nom Descriptif Valeur

RedisCreatePropertiesOrRedisProperties

Nom Descriptif Valeur
disableAccessKeyAuthentication L’authentification auprès de Redis par le biais de clés d’accès est désactivée lorsqu’elle est définie sur true. La valeur par défaut est false. Bool
enableNonSslPort Spécifie si le port du serveur Redis non ssl (6379) est activé. Bool
minimumTlsVersion Facultatif : nécessite que les clients utilisent une version TLS spécifiée (ou une version ultérieure) pour se connecter (par exemple, « 1.0 », « 1.1 », « 1.2 ») '1.0'
'1.1'
'1.2'
publicNetworkAccess Indique si l’accès au point de terminaison public est autorisé pour ce cache. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé ». Si « Désactivé », les points de terminaison privés sont la méthode d’accès exclusif. 'Désactivé'
'Activé'
redisConfiguration Tous les paramètres Redis. Peu de clés possibles : 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-string-1, etc. RedisCommonPropertiesRedisConfiguration
redisVersion Version de Redis. Il doit s’agir de la forme « major[.minor] » (seul « major » est requis) ou de la valeur « latest » qui fait référence à la dernière version stable de Redis disponible. Versions prises en charge : 4.0, 6.0 (dernière version). La valeur par défaut est « latest ». corde
répliquesPerMaster Nombre de réplicas à créer par réplica principal. Int
réplicasPerPrimary Nombre de réplicas à créer par réplica principal. Int
shardCount Nombre de partitions à créer sur un cache de cluster Premium. Int
Sku Référence SKU du cache Redis à déployer. référence SKU (obligatoire)
staticIP Adresse IP statique. Si vous le souhaitez, vous pouvez spécifier le déploiement d’un cache Redis à l’intérieur d’un réseau virtuel Azure existant ; automatiquement affecté par défaut. corde

Contraintes:
Modèle = ^\d+\.\d+\.\d+\.\d+$
subnetId ID de ressource complet d’un sous-réseau dans un réseau virtuel dans lequel déployer le cache Redis. Exemple de format : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Network|ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1 corde

Contraintes:
Modèle = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
tenantSettings Dictionnaire des paramètres de locataire RedisCommonPropertiesTenantSettings
updateChannel Facultatif : spécifie le canal de mise à jour pour les mises à jour mensuelles de Redis que votre cache Redis recevra. Les caches utilisant le canal de mise à jour « Préversion » obtiennent les dernières mises à jour Redis au moins 4 semaines à l’avance sur les caches de canal « Stable ». La valeur par défaut est « Stable ». 'Avant-première'
'Stable'
zonalAllocationPolicy Facultatif : spécifie la façon dont les zones de disponibilité sont allouées au cache Redis. « Automatique » active la redondance de zone et Azure sélectionne automatiquement les zones en fonction de la disponibilité et de la capacité régionales. « UserDefined » sélectionne les zones de disponibilité transmises par vous à l’aide du paramètre « zones ». 'NoZones' produit un cache non zonal. Si « zonalAllocationPolicy » n’est pas passé, il est défini sur « UserDefined » lorsque les zones sont passées ; sinon, elle est définie sur « Automatique » dans les régions où les zones sont prises en charge et « NoZones » dans les régions où les zones ne sont pas prises en charge. 'Automatique'
'NoZones'
'Défini par l’utilisateur'

Sku

Nom Descriptif Valeur
capacité Taille du cache Redis à déployer. Valeurs valides : pour la famille C (De base/Standard) (0, 1, 2, 3, 4, 5, 6), pour la famille P (Premium) (1, 2, 3, 4). int (obligatoire)
Famille Famille de références SKU à utiliser. Valeurs valides : (C, P). (C = De base/Standard, P = Premium). 'C'
'P' (obligatoire)
nom Type de cache Redis à déployer. Valeurs valides : (De base, Standard, Premium) 'De base'
« Haut de gamme »
'Standard' (obligatoire)

UserAssignedIdentities

Nom Descriptif Valeur

userAssignedIdentity

Nom Descriptif Valeur

Exemples d’utilisation

Échantillons Terraform

Un exemple de base de déploiement du 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    = ["*"]
}

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Descriptif
cache Redis Module de ressources AVM pour le cache Redis