Redis - Update

Service:: Redis Cache

Version d'API:: 2024-11-01

Mettez à jour un cache Redis existant.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}?api-version=2024-11-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
name	path	True	string	Le nom de la RedisResource
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
identity	ManagedServiceIdentity	Identité de la ressource.
properties.disableAccessKeyAuthentication	boolean	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.
properties.enableNonSslPort	boolean	Spécifie si le port du serveur Redis non ssl (6379) est activé.
properties.minimumTlsVersion	TlsVersion	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 »)
properties.publicNetworkAccess	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.
properties.redisConfiguration	RedisCommonPropertiesRedisConfiguration	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.
properties.redisVersion	string	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 ».
properties.replicasPerMaster	integer (int32)	Nombre de réplicas à créer par réplica principal.
properties.replicasPerPrimary	integer (int32)	Nombre de réplicas à créer par réplica principal.
properties.shardCount	integer (int32)	Nombre de partitions à créer sur un cache de cluster Premium.
properties.sku	Sku	Référence SKU du cache Redis à déployer.
properties.tenantSettings	object	Dictionnaire des paramètres de locataire
properties.updateChannel	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 ».
properties.zonalAllocationPolicy	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.
tags	object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	RedisResource	La demande a réussi.
202 Accepted	RedisResource	Le traitement de la demande a été accepté, mais le traitement n’est pas encore terminé. En-têtes Location: string
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Nom

Type

Description

200 OK

RedisResource

La demande a réussi.

202 Accepted

RedisResource

Le traitement de la demande a été accepté, mais le traitement n’est pas encore terminé.

En-têtes

Location: string

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

RedisCacheUpdate

Exemple de requête

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Cache/redis/cache1?api-version=2024-11-01

{
  "properties": {
    "enableNonSslPort": true,
    "replicasPerPrimary": 2
  }
}

Exemple de réponse

Code d’état:: 200

{
  "name": "cache1",
  "type": "Microsoft.Cache/Redis",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Cache/Redis/cache1",
  "location": "East US",
  "properties": {
    "accessKeys": {
      "primaryKey": "<primaryKey>",
      "secondaryKey": "<secondaryKey>"
    },
    "enableNonSslPort": true,
    "hostName": "cache1.redis.cache.windows.net",
    "instances": [
      {
        "isMaster": true,
        "isPrimary": true,
        "nonSslPort": 13000,
        "sslPort": 15000
      },
      {
        "isMaster": false,
        "isPrimary": false,
        "nonSslPort": 13001,
        "sslPort": 15001
      },
      {
        "isMaster": false,
        "isPrimary": false,
        "nonSslPort": 13002,
        "sslPort": 15002
      }
    ],
    "port": 6379,
    "provisioningState": "Succeeded",
    "redisConfiguration": {
      "maxclients": "1000",
      "maxmemory-delta": "50",
      "maxmemory-reserved": "50"
    },
    "redisVersion": "3.0",
    "replicasPerMaster": 2,
    "replicasPerPrimary": 2,
    "sku": {
      "name": "Premium",
      "capacity": 1,
      "family": "P"
    },
    "sslPort": 6380,
    "updateChannel": "Stable",
    "zonalAllocationPolicy": "Automatic"
  },
  "tags": {}
}

Code d’état:: 202

location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Cache/...pathToOperationResult...

{
  "name": "cache1",
  "type": "Microsoft.Cache/Redis",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Cache/Redis/cache1",
  "location": "East US",
  "properties": {
    "accessKeys": {
      "primaryKey": "<primaryKey>",
      "secondaryKey": "<secondaryKey>"
    },
    "enableNonSslPort": true,
    "hostName": "cache1.redis.cache.windows.net",
    "instances": [
      {
        "isMaster": true,
        "isPrimary": true,
        "nonSslPort": 13000,
        "sslPort": 15000
      },
      {
        "isMaster": false,
        "isPrimary": false,
        "nonSslPort": 13001,
        "sslPort": 15001
      },
      {
        "isMaster": false,
        "isPrimary": false,
        "nonSslPort": 13002,
        "sslPort": 15002
      }
    ],
    "port": 6379,
    "provisioningState": "Succeeded",
    "redisConfiguration": {
      "maxclients": "1000",
      "maxmemory-delta": "50",
      "maxmemory-reserved": "50"
    },
    "redisVersion": "3.0",
    "replicasPerMaster": 2,
    "replicasPerPrimary": 2,
    "sku": {
      "name": "Premium",
      "capacity": 1,
      "family": "P"
    },
    "sslPort": 6380,
    "updateChannel": "Stable",
    "zonalAllocationPolicy": "Automatic"
  },
  "tags": {}
}

Définitions

Nom	Description
createdByType	Type d’identité qui a créé la ressource.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
ManagedServiceIdentity	Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)
ManagedServiceIdentityType	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).
PrivateEndpoint	Ressource de point de terminaison privé.
PrivateEndpointConnection	Ressource de connexion de point de terminaison privé.
PrivateEndpointConnectionProvisioningState	État d’approvisionnement actuel.
PrivateEndpointServiceConnectionStatus	État de la connexion de point de terminaison privé.
PrivateLinkServiceConnectionState	Collection d’informations sur l’état de la connexion entre le consommateur de services et le fournisseur.
ProvisioningState	État d’approvisionnement de l’instance Redis.
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. La valeur par défaut est « Enabled »
RedisAccessKeys	Clés d’accès du cache Redis.
RedisCommonPropertiesRedisConfiguration	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.
RedisInstanceDetails	Détails de l’instance unique de redis.
RedisLinkedServer	ID de serveur lié
RedisResource	Élément Redis unique dans l’opération Liste ou Obtenir.
RedisUpdateParameters	Paramètres fournis à l’opération Update Redis.
Sku	Paramètres de référence SKU fournis pour l’opération de création de Redis.
SkuFamily	Famille de références SKU à utiliser. Valeurs valides : (C, P). (C = De base/Standard, P = Premium).
SkuName	Type de cache Redis à déployer. Valeurs valides : (De base, Standard, Premium)
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
TlsVersion	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 »)
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 ».
UserAssignedIdentity	Propriétés d’identité attribuées par l’utilisateur
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.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

ManagedServiceIdentity

Object

Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)

Nom	Type	Description
principalId	string (uuid)	ID du principal de service de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
tenantId	string (uuid)	ID de locataire de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
type	ManagedServiceIdentityType	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).
userAssignedIdentities	<string, UserAssignedIdentity>	identités User-Assigned 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.

ManagedServiceIdentityType

Énumération

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

Valeur	Description
None
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned

PrivateEndpoint

Object

Ressource de point de terminaison privé.

Nom	Type	Description
id	string	Identificateur ARM pour le point de terminaison privé.

PrivateEndpointConnection

Object

Ressource de connexion de point de terminaison privé.

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
name	string	Nom de la ressource
properties.groupIds	string[]	ID de groupe pour la ressource de point de terminaison privé.
properties.privateEndpoint	PrivateEndpoint	Ressource de point de terminaison privé.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Collection d’informations sur l’état de la connexion entre le consommateur de services et le fournisseur.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	État d’approvisionnement de la ressource de connexion de point de terminaison privé.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

PrivateEndpointConnectionProvisioningState

Énumération

État d’approvisionnement actuel.

Valeur	Description
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

Énumération

État de la connexion de point de terminaison privé.

Valeur	Description
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Object

Collection d’informations sur l’état de la connexion entre le consommateur de services et le fournisseur.

Nom	Type	Description
actionsRequired	string	Message indiquant si les modifications apportées au fournisseur de services nécessitent des mises à jour sur le consommateur.
description	string	Raison de l’approbation/rejet de la connexion.
status	PrivateEndpointServiceConnectionStatus	Indique si la connexion a été approuvée/rejetée/supprimée par le propriétaire du service.

ProvisioningState

Énumération

État d’approvisionnement de l’instance Redis.

Valeur	Description
Creating	Une opération de création est en cours.
Deleting	Une opération de suppression est en cours.
Disabled	Le cache est désactivé et ne peut pas être utilisé.
Failed	Echec d’une opération telle que la création ou la mise à jour. Si vous n’avez pas réussi à créer le cache, il ne sera pas dans un état utilisable, vous devez donc le supprimer et le recréer.
Linking	Le lien de géoréplication est en cours
Provisioning	Une opération est en cours
RecoveringScaleFailure	Une opération de mise à l’échelle a rencontré une erreur et la récupération est en cours.
Scaling	Une opération de mise à l’échelle est en cours
Succeeded	La dernière opération réalisée avec succès
Unlinking	La dissociation de la géoréplication est en cours
Unprovisioning	Le cache est peut-être en cours de désactivation
Updating	Une opération de mise à jour est en cours.
ConfiguringAAD	Une opération de mise à jour de la configuration AAD est en cours.

PublicNetworkAccess

Énumération

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. La valeur par défaut est « Enabled »

Valeur	Description
Enabled	L’accès Internet public au cache, via son adresse IP publique, est activé. Les connexions peuvent utiliser n’importe quel chemin d’accès réseau.
Disabled	L’accès Internet public au cache, via son adresse IP publique, est désactivé. Les connexions doivent être établies via des points de terminaison privés.

RedisAccessKeys

Object

Clés d’accès du cache Redis.

Nom	Type	Description
primaryKey	string	Clé primaire actuelle que les clients peuvent utiliser pour s’authentifier auprès du cache Redis.
secondaryKey	string	Clé secondaire actuelle que les clients peuvent utiliser pour s’authentifier auprès du cache Redis.

RedisCommonPropertiesRedisConfiguration

Object

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.

Nom	Type	Description
aad-enabled	string	Spécifie si l’authentification basée sur AAD a été activée ou désactivée pour le cache
aof-backup-enabled	string	Spécifie si la sauvegarde aof est activée
aof-storage-connection-string-0	string	Première chaîne de connexion de compte de stockage
aof-storage-connection-string-1	string	Deuxième chaîne de connexion de compte de stockage
authnotrequired	string	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é !
maxclients	string	Configuration maximale des clients
maxfragmentationmemory-reserved	string	Valeur en mégaoctets réservés pour la fragmentation par partition
maxmemory-delta	string	Valeur en mégaoctets réservés pour l’utilisation non du cache par partition, par exemple le basculement.
maxmemory-policy	string	La stratégie d’éviction utilisée lorsque vos données ne correspondent pas à sa limite de mémoire.
maxmemory-reserved	string	Valeur en mégaoctets réservés pour l’utilisation non du cache par partition, par exemple le basculement.
notify-keyspace-events	string	Événements d’espace de clés qui doivent être surveillés.
preferred-data-archive-auth-method	string	Méthode d’authentification préférée pour communiquer avec le compte de stockage utilisé pour l’archivage des données, spécifier SAS ou ManagedIdentity, la valeur par défaut est SAS
preferred-data-persistence-auth-method	string	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
rdb-backup-enabled	string	Spécifie si la sauvegarde RDB est activée
rdb-backup-frequency	string	Spécifie la fréquence de création d’une sauvegarde rdb en minutes. Valeurs valides : (15, 30, 60, 360, 720, 1440)
rdb-backup-max-snapshot-count	string	Spécifie le nombre maximal d’instantanés pour la sauvegarde rdb
rdb-storage-connection-string	string	Chaîne de connexion de compte de stockage pour le stockage du fichier rdb
storage-subscription-id	string	SubscriptionId du compte de stockage pour la persistance (aof/rdb) à l’aide de ManagedIdentity.
zonal-configuration	string	Configuration zonale

RedisInstanceDetails

Object

Détails de l’instance unique de redis.

Nom	Type	Description
isMaster	boolean	Spécifie si l’instance est un nœud principal.
isPrimary	boolean	Spécifie si l’instance est un nœud principal.
nonSslPort	integer (int32)	Si enableNonSslPort a la valeur true, fournit le port Non-SSL de l’instance Redis.
shardId	integer (int32)	Si le clustering est activé, l’ID de partition de l’instance Redis
sslPort	integer (int32)	Port SSL de l’instance Redis.
zone	string	Si le cache utilise des zones de disponibilité, spécifie la zone de disponibilité où se trouve cette instance.

RedisLinkedServer

Object

ID de serveur lié

Nom	Type	Description
id	string	ID de serveur lié.

RedisResource

Object

Élément Redis unique dans l’opération Liste ou Obtenir.

Nom	Type	Valeur par défaut	Description
disableAccessKeyAuthentication	boolean	False	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.
enableNonSslPort	boolean	False	Spécifie si le port du serveur Redis non ssl (6379) est activé.
id	string (arm-id)		ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
identity	ManagedServiceIdentity		Identités de service managées affectées à cette ressource.
location	string		Emplacement géographique où réside la ressource
minimumTlsVersion	TlsVersion		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 »)
name	string		Nom de la ressource
properties.accessKeys	RedisAccessKeys		Clés du cache Redis - non définie si cet objet n’est pas la réponse au cache Redis Créer ou mettre à jour
properties.hostName	string		Nom d’hôte Redis.
properties.instances	RedisInstanceDetails[]		Liste des instances Redis associées au cache
properties.linkedServers	RedisLinkedServer[]		Liste des serveurs liés associés au cache
properties.port	integer (int32)		Port Redis non SSL.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Liste des connexions de point de terminaison privé associées au cache redis spécifié
properties.provisioningState	ProvisioningState		État d’approvisionnement de l’instance Redis.
properties.sku	Sku		Référence SKU du cache Redis à déployer.
properties.sslPort	integer (int32)		Port SSL Redis.
properties.staticIP	string pattern: ^\d+\.\d+\.\d+\.\d+$		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.
properties.subnetId	string pattern: ^/subscriptions/[^/]/resourceGroups/[^/]/providers/Microsoft.(ClassicNetwork\|Network)/virtualNetworks/[^/]/subnets/[^/]$		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
publicNetworkAccess	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.
redisConfiguration	RedisCommonPropertiesRedisConfiguration		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.
redisVersion	string		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 ».
replicasPerMaster	integer (int32)		Nombre de réplicas à créer par réplica principal.
replicasPerPrimary	integer (int32)		Nombre de réplicas à créer par réplica principal.
shardCount	integer (int32)		Nombre de partitions à créer sur un cache de cluster Premium.
systemData	systemData		Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object		Balises de ressource.
tenantSettings	object		Dictionnaire des paramètres de locataire
type	string		Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »
updateChannel	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 ».
zonalAllocationPolicy	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.
zones	string[]		Zones de disponibilité.

RedisUpdateParameters

Object

Paramètres fournis à l’opération Update Redis.

Nom	Type	Valeur par défaut	Description
identity	ManagedServiceIdentity		Identité de la ressource.
properties.disableAccessKeyAuthentication	boolean	False	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.
properties.enableNonSslPort	boolean	False	Spécifie si le port du serveur Redis non ssl (6379) est activé.
properties.minimumTlsVersion	TlsVersion		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 »)
properties.publicNetworkAccess	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.
properties.redisConfiguration	RedisCommonPropertiesRedisConfiguration		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.
properties.redisVersion	string		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 ».
properties.replicasPerMaster	integer (int32)		Nombre de réplicas à créer par réplica principal.
properties.replicasPerPrimary	integer (int32)		Nombre de réplicas à créer par réplica principal.
properties.shardCount	integer (int32)		Nombre de partitions à créer sur un cache de cluster Premium.
properties.sku	Sku		Référence SKU du cache Redis à déployer.
properties.tenantSettings	object		Dictionnaire des paramètres de locataire
properties.updateChannel	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 ».
properties.zonalAllocationPolicy	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.
tags	object		Balises de ressource.

Sku

Object

Paramètres de référence SKU fournis pour l’opération de création de Redis.

Nom	Type	Description
capacity	integer (int32)	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).
family	SkuFamily	Famille de références SKU à utiliser. Valeurs valides : (C, P). (C = De base/Standard, P = Premium).
name	SkuName	Type de cache Redis à déployer. Valeurs valides : (De base, Standard, Premium)

SkuFamily

Énumération

Famille de références SKU à utiliser. Valeurs valides : (C, P). (C = De base/Standard, P = Premium).

Valeur	Description
C	La famille de références SKU à utiliser doit être « C » pour les caches Redis de référence SKU de base/standard.
P	La famille de références SKU à utiliser doit être « P » pour les caches Redis de référence SKU Premium.

SkuName

Énumération

Type de cache Redis à déployer. Valeurs valides : (De base, Standard, Premium)

Valeur	Description
Basic	La référence SKU « de base » bien connue pour Azure Cache pour Redis. La référence SKU de base n’a pas de contrat SLA de disponibilité.
Standard	La référence SKU « Standard » bien connue pour Azure Cache pour Redis. La référence SKU standard dispose d’un SLA de disponibilité.
Premium	La référence SKU « Premium » bien connue pour Azure Cache pour Redis. La référence SKU Premium dispose d’un contrat SLA de disponibilité, de niveaux de performances plus élevés et de plus de fonctionnalités par rapport à la référence SKU Standard.

systemData

Object

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

TlsVersion

Énumération

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 »)

Valeur	Description
1.0	Protocole TLS version 1.0 -- obsolète pour des raisons de sécurité. N’utilisez pas cette valeur pour de nouveaux caches.
1.1	Protocole TLS version 1.1 -- obsolète pour des raisons de sécurité. N’utilisez pas cette valeur pour de nouveaux caches.
1.2	Protocole TLS version 1.2 -- utilisez cette valeur, ou supérieure, pour les nouveaux caches. Ou ne spécifiez pas, afin que votre cache utilise la valeur par défaut recommandée

UpdateChannel

Énumération

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 ».

Valeur	Description
Stable	Le canal stable reçoit les mises à jour, qui peuvent inclure des mises à jour importantes de sécurité et de stabilité, plus tard que le canal en préversion.
Preview	Le canal de préversion reçoit normalement les mises à jour avant le canal stable et est le canal recommandé pour les charges de travail hors production.

UserAssignedIdentity

Object

Propriétés d’identité attribuées par l’utilisateur

Nom	Type	Description
clientId	string (uuid)	ID client de l’identité affectée.
principalId	string (uuid)	ID principal de l’identité affectée.

ZonalAllocationPolicy

Énumération

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.

Valeur	Description
Automatic	Les zones du cache seront sélectionnées automatiquement en fonction de la disponibilité et de la capacité.
UserDefined	UserDefined signifie que les zones du cache sont configurées manuellement à l’aide de la propriété 'zones' et ne peuvent pas être sélectionnées automatiquement.
NoZones	Le cache n’utilisera pas plusieurs zones de disponibilité.

Partager via

Redis - Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

RedisCacheUpdate

Exemple de requête

Exemple de réponse

Définitions

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedServiceIdentity

ManagedServiceIdentityType

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProvisioningState

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

ProvisioningState

PublicNetworkAccess

RedisAccessKeys

RedisCommonPropertiesRedisConfiguration

RedisInstanceDetails

RedisLinkedServer

RedisResource

RedisUpdateParameters

Sku

SkuFamily

SkuName

systemData

TlsVersion

UpdateChannel

UserAssignedIdentity

ZonalAllocationPolicy