Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 |
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 + Cache Redis + BASE de données SQL avec un modèle |
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 |
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. |
|
Créer deux caches géorépliqués dans un de réseau virtuel |
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 |
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 |
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 |
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 |