---
title: "PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}"
method: PATCH
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}"
tags: ["RedisResources"]
---

# PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}

`PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}`

Update an existing Redis cache.

## Path parameters

- `name` string, required

## Parameters

- `../../../../../../common-types/resource-management/v4/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v4/types.json#/components/parameters/SubscriptionIdParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v4/types.json#/components/parameters/ResourceGroupNameParameter` — unresolved $ref

## Request body

- RedisUpdateParameters — Parameters supplied to the Update Redis operation.
  - `properties` RedisUpdateProperties — Create/Update/Get common properties of the redis cache.
    - `redisConfiguration` RedisCommonPropertiesRedisConfiguration — All Redis Settings. Few possible keys: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta, maxmemory-policy,notify-keyspace-events, aof-backup-enabled, aof-storage-connection-string-0, aof-storage-connection-string-1 etc.
      - `rdb-backup-enabled` string — Specifies whether the RDB backup is enabled
      - `rdb-backup-frequency` string — Specifies the frequency for creating rdb backup in minutes. Valid values: (15, 30, 60, 360, 720, 1440)
      - `rdb-backup-max-snapshot-count` string — Specifies the maximum number of snapshots for rdb backup
      - `rdb-storage-connection-string` string — The storage account connection string for storing rdb file
      - `aof-backup-enabled` string — Specifies whether the aof backup is enabled
      - `aof-storage-connection-string-0` string — First storage account connection string
      - `aof-storage-connection-string-1` string — Second storage account connection string
      - `maxfragmentationmemory-reserved` string — Value in megabytes reserved for fragmentation per shard
      - `maxmemory-policy` string — The eviction strategy used when your data won't fit within its memory limit.
      - `maxmemory-reserved` string — Value in megabytes reserved for non-cache usage per shard e.g. failover.
      - `maxmemory-delta` string — Value in megabytes reserved for non-cache usage per shard e.g. failover.
      - `maxclients` string — The max clients config
      - `notify-keyspace-events` string — The keyspace events which should be monitored.
      - `preferred-data-archive-auth-method` string — Preferred auth method to communicate to storage account used for data archive, specify SAS or ManagedIdentity, default value is SAS
      - `preferred-data-persistence-auth-method` string — Preferred auth method to communicate to storage account used for data persistence, specify SAS or ManagedIdentity, default value is SAS
      - `zonal-configuration` string — Zonal Configuration
      - `authnotrequired` string — Specifies whether the authentication is disabled. Setting this property is highly discouraged from security point of view; you should never disable authentication using this property!
      - `storage-subscription-id` string — SubscriptionId of the storage account for persistence (aof/rdb) using ManagedIdentity.
      - `aad-enabled` string — Specifies whether AAD based authentication has been enabled or disabled for the cache
    - `redisVersion` string — Redis version. This should be in the form 'major[.minor]' (only 'major' is required) or the value 'latest' which refers to the latest stable Redis version that is available. Supported versions: 4.0, 6.0 (latest). Default value is 'latest'.
    - `enableNonSslPort` boolean — Specifies whether the non-ssl Redis server port (6379) is enabled.
    - `replicasPerMaster` integer — The number of replicas to be created per primary.
    - `replicasPerPrimary` integer — The number of replicas to be created per primary.
    - `tenantSettings` object — A dictionary of tenant settings
    - `shardCount` integer — The number of shards to be created on a Premium Cluster Cache.
    - `minimumTlsVersion` '1.0' | '1.1' | '1.2' — Optional: requires clients to use a specified TLS version (or higher) to connect (e,g, '1.0', '1.1', '1.2')
    - `publicNetworkAccess` 'Enabled' | 'Disabled' — Whether or not public endpoint access is allowed for this cache. Value is optional but if passed in, must be 'Enabled' or 'Disabled'. If 'Disabled', private endpoints are the exclusive access method. Default value is 'Enabled'
    - `updateChannel` 'Stable' | 'Preview' — Optional: Specifies the update channel for the monthly Redis updates your Redis Cache will receive. Caches using 'Preview' update channel get latest Redis updates at least 4 weeks ahead of 'Stable' channel caches. Default value is 'Stable'.
    - `disableAccessKeyAuthentication` boolean — Authentication to Redis through access keys is disabled when set as true. Default value is false.
    - `zonalAllocationPolicy` 'Automatic' | 'UserDefined' | 'NoZones' — Optional: Specifies how availability zones are allocated to the Redis cache. 'Automatic' enables zone redundancy and Azure will automatically select zones based on regional availability and capacity. 'UserDefined' will select availability zones passed in by you using the 'zones' parameter. 'NoZones' will produce a non-zonal cache. If 'zonalAllocationPolicy' is not passed, it will be set to 'UserDefined' when zones are passed in, otherwise, it will be set to 'Automatic' in regions where zones are supported and 'NoZones' in regions where zones are not supported.
  - `tags` object — Resource tags.
  - `identity` ManagedServiceIdentity — unresolved $ref

## Response `200`

The request has succeeded.

- RedisResource — unresolved $ref

## Other responses

- `202` — The request has been accepted for processing, but processing has not yet completed.
- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2015-08-01) `24a339e685f0` — 2 info
  - api tag `RedisResources` added
  - api tag `Redis` removed
- **2026-07-13** (2015-08-01) `51855df55313` — 3 warning
  - deleted the `path` request parameter `resourceGroupName`
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
- **2026-07-13** (2015-08-01) `00f9cf6e5536` — 1 info
  - added the success response with the status `202`
- **2026-07-13** (2015-08-01) `169ccc708377` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/redis-microsoft-cache-redis/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.Cache/redis/:name/patch.md)

---

[API](https://skmtc.dev/azure/apis/redis-microsoft-cache-redis.md) · [All operations](https://skmtc.dev/azure/apis/redis-microsoft-cache-redis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/redis-microsoft-cache-redis/revisions/24a339e685f0/schema)