你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Redis - Update

服务:: Redis Cache

API 版本:: 2024-11-01

更新现有的 Redis 缓存。

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

URI 参数

名称	在	必需	类型	说明
name	path	True	string	RedisResource 的名称
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。名称不区分大小写。
subscriptionId	path	True	string (uuid)	目标订阅的 ID。该值必须是 UUID。
api-version	query	True	string minLength: 1	用于此操作的 API 版本。

请求正文

名称	类型	说明
identity	ManagedServiceIdentity	资源的标识。
properties.disableAccessKeyAuthentication	boolean	如果设置为 true，则会禁用通过访问密钥向 Redis 进行身份验证。默认值为 false。
properties.enableNonSslPort	boolean	指定是否启用非 ssl Redis 服务器端口（6379）。
properties.minimumTlsVersion	TlsVersion	可选：要求客户端使用指定的 TLS 版本（或更高版本）进行连接（例如，“1.0”、“1.1”、“1.2”）
properties.publicNetworkAccess	PublicNetworkAccess	是否允许对此缓存使用公共终结点访问。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”。如果为“Disabled”，则专用终结点是独占访问方法。
properties.redisConfiguration	RedisCommonPropertiesRedisConfiguration	所有 Redis 设置。很少有可能的密钥：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 等。
properties.redisVersion	string	Redis 版本。这应采用“major[.minor]”（仅需要“major”）或值“latest”，该值引用可用的最新稳定 Redis 版本。支持的版本：4.0、6.0（最新版）。默认值为“latest”。
properties.replicasPerMaster	integer (int32)	要为每个主要副本创建的副本数。
properties.replicasPerPrimary	integer (int32)	要为每个主要副本创建的副本数。
properties.shardCount	integer (int32)	在高级群集缓存上创建的分片数。
properties.sku	Sku	要部署的 Redis 缓存的 SKU。
properties.tenantSettings	object	租户设置字典
properties.updateChannel	UpdateChannel	可选：指定 Redis 缓存将接收的每月 Redis 更新的更新通道。使用“预览”更新通道的缓存在“稳定”通道缓存之前至少提前 4 周获取最新的 Redis 更新。默认值为“Stable”。
properties.zonalAllocationPolicy	ZonalAllocationPolicy	可选：指定如何将可用性区域分配给 Redis 缓存。 “自动”启用区域冗余，Azure 将根据区域可用性和容量自动选择区域。 “UserDefined”将使用“zone”参数选择传入的可用性区域。 “NoZones”将生成非区域性缓存。如果未传递“zonalAllocationPolicy”，则会在传入区域时将其设置为“UserDefined”，否则，在不支持区域的区域中，将设置为“自动”，在不支持区域的区域中将其设置为“NoZones”。
tags	object	资源标记。

响应

名称	类型	说明
200 OK	RedisResource	请求已成功。
202 Accepted	RedisResource	已接受请求进行处理，但尚未完成处理。标头 Location: string
Other Status Codes	ErrorResponse	意外错误响应。

名称

类型

说明

200 OK

RedisResource

请求已成功。

202 Accepted

RedisResource

已接受请求进行处理，但尚未完成处理。

标头

Location: string

Other Status Codes

ErrorResponse

意外错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

RedisCacheUpdate

示例请求

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

示例响应

状态代码:: 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": {}
}

状态代码:: 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": {}
}

定义

名称	说明
createdByType	创建资源的标识的类型。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
ManagedServiceIdentity	托管服务标识（系统分配和/或用户分配的标识）
ManagedServiceIdentityType	托管服务标识的类型（其中允许 SystemAssigned 和 UserAssigned 类型）。
PrivateEndpoint	专用终结点资源。
PrivateEndpointConnection	专用终结点连接资源。
PrivateEndpointConnectionProvisioningState	当前预配状态。
PrivateEndpointServiceConnectionStatus	专用终结点连接状态。
PrivateLinkServiceConnectionState	有关服务使用者与提供程序之间的连接状态的信息集合。
ProvisioningState	Redis 实例预配状态。
PublicNetworkAccess	是否允许对此缓存使用公共终结点访问。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”。如果为“Disabled”，则专用终结点是独占访问方法。默认值为“Enabled”
RedisAccessKeys	Redis 缓存访问密钥。
RedisCommonPropertiesRedisConfiguration	所有 Redis 设置。很少有可能的密钥：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 等。
RedisInstanceDetails	redis 单个实例的详细信息。
RedisLinkedServer	链接服务器 ID
RedisResource	列表或获取操作中的单个 Redis 项。
RedisUpdateParameters	提供给 Update Redis 操作的参数。
Sku	提供给创建 Redis 操作的 SKU 参数。
SkuFamily	要使用的 SKU 系列。有效值：（C、P）。（C = 基本/标准，P = 高级）。
SkuName	要部署的 Redis 缓存的类型。有效值：（基本、标准、高级）
systemData	与创建和上次修改资源相关的元数据。
TlsVersion	可选：要求客户端使用指定的 TLS 版本（或更高版本）进行连接（例如，“1.0”、“1.1”、“1.2”）
UpdateChannel	可选：指定 Redis 缓存将接收的每月 Redis 更新的更新通道。使用“预览”更新通道的缓存在“稳定”通道缓存之前至少提前 4 周获取最新的 Redis 更新。默认值为“Stable”。
UserAssignedIdentity	用户分配的标识属性
ZonalAllocationPolicy	可选：指定如何将可用性区域分配给 Redis 缓存。 “自动”启用区域冗余，Azure 将根据区域可用性和容量自动选择区域。 “UserDefined”将使用“zone”参数选择传入的可用性区域。 “NoZones”将生成非区域性缓存。如果未传递“zonalAllocationPolicy”，则会在传入区域时将其设置为“UserDefined”，否则，在不支持区域的区域中，将设置为“自动”，在不支持区域的区域中将其设置为“NoZones”。

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

ManagedServiceIdentity

Object

托管服务标识（系统分配和/或用户分配的标识）

名称	类型	说明
principalId	string (uuid)	系统分配标识的服务主体 ID。此属性仅针对系统分配的标识提供。
tenantId	string (uuid)	系统分配标识的租户 ID。此属性仅针对系统分配的标识提供。
type	ManagedServiceIdentityType	托管服务标识的类型（其中允许 SystemAssigned 和 UserAssigned 类型）。
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned 标识与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将为 ARM 资源 ID，格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。字典值可以是请求中的空对象（{}）。

ManagedServiceIdentityType

枚举

托管服务标识的类型（其中允许 SystemAssigned 和 UserAssigned 类型）。

值	说明
None
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned

PrivateEndpoint

Object

专用终结点资源。

名称	类型	说明
id	string	专用终结点的 ARM 标识符。

PrivateEndpointConnection

Object

专用终结点连接资源。

名称	类型	说明
id	string (arm-id)	资源的完全限定资源 ID。例如，“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	资源的名称
properties.groupIds	string[]	专用终结点资源的组 ID。
properties.privateEndpoint	PrivateEndpoint	专用终结点资源。
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	有关服务使用者与提供程序之间的连接状态的信息集合。
properties.provisioningState	PrivateEndpointConnectionProvisioningState	专用终结点连接资源的预配状态。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type	string	资源的类型。例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

PrivateEndpointConnectionProvisioningState

枚举

当前预配状态。

值	说明
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

枚举

专用终结点连接状态。

值	说明
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Object

有关服务使用者与提供程序之间的连接状态的信息集合。

名称	类型	说明
actionsRequired	string	一条消息，指示服务提供商上的更改是否需要对使用者进行任何更新。
description	string	批准/拒绝连接的原因。
status	PrivateEndpointServiceConnectionStatus	指示连接是否已被服务的所有者批准/拒绝/删除。

ProvisioningState

枚举

Redis 实例预配状态。

值	说明
Creating	创建作正在进行中。
Deleting	正在进行删除作。
Disabled	缓存已禁用，无法使用。
Failed	创建或更新等作失败。如果创建缓存失败，它将不会处于可用状态，因此您应该删除并重新创建它。
Linking	异地复制链接正在进行中
Provisioning	作正在进行中
RecoveringScaleFailure	缩放作遇到错误，正在进行恢复。
Scaling	缩放作正在进行中
Succeeded	最近一次作成功完成
Unlinking	异地复制取消链接正在进行中
Unprovisioning	缓存可能被禁用
Updating	更新作正在进行中。
ConfiguringAAD	AAD 配置更新作正在进行中。

PublicNetworkAccess

枚举

是否允许对此缓存使用公共终结点访问。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”。如果为“Disabled”，则专用终结点是独占访问方法。默认值为“Enabled”

值	说明
Enabled	通过其公共 IP 地址启用对缓存的公共 Internet 访问。连接可以使用任何网络路径。
Disabled	通过其公共 IP 地址对缓存的公共 Internet 访问被禁用。必须使用通过专用终结点建立连接。

RedisAccessKeys

Object

Redis 缓存访问密钥。

名称	类型	说明
primaryKey	string	客户端可用于通过 Redis 缓存进行身份验证的当前主密钥。
secondaryKey	string	客户端可用于对 Redis 缓存进行身份验证的当前辅助密钥。

RedisCommonPropertiesRedisConfiguration

Object

所有 Redis 设置。很少有可能的密钥：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 等。

名称	类型	说明
aad-enabled	string	指定是否已为缓存启用或禁用基于 AAD 的身份验证
aof-backup-enabled	string	指定是否启用 aof 备份
aof-storage-connection-string-0	string	第一个存储帐户连接字符串
aof-storage-connection-string-1	string	第二个存储帐户连接字符串
authnotrequired	string	指定是否禁用身份验证。从安全角度来看，强烈建议不要设置此属性;您永远不应该使用此属性禁用身份验证！
maxclients	string	最大客户端配置
maxfragmentationmemory-reserved	string	每个分片的碎片保留的以兆字节为单位的值
maxmemory-delta	string	为每个分片保留的非缓存使用量（例如故障转移）的值（以兆字节为单位）。
maxmemory-policy	string	当数据不符合其内存限制时使用的逐出策略。
maxmemory-reserved	string	为每个分片保留的非缓存使用量（例如故障转移）的值（以兆字节为单位）。
notify-keyspace-events	string	应监视的键空间事件。
preferred-data-archive-auth-method	string	用于与用于数据存档的存储帐户通信的首选身份验证方法，指定 SAS 或 ManagedIdentity，默认值为 SAS
preferred-data-persistence-auth-method	string	首选身份验证方法，用于与用于数据暂留的存储帐户通信，指定 SAS 或 ManagedIdentity，默认值为 SAS
rdb-backup-enabled	string	指定是否启用 RDB 备份
rdb-backup-frequency	string	指定创建 rdb 备份的频率（以分钟为单位）。有效值：（15、30、60、360、720、1440）
rdb-backup-max-snapshot-count	string	指定 rdb 备份的最大快照数
rdb-storage-connection-string	string	用于存储 rdb 文件的存储帐户连接字符串
storage-subscription-id	string	使用 ManagedIdentity 的存储帐户的 SubscriptionId（aof/rdb）。
zonal-configuration	string	区域配置

RedisInstanceDetails

Object

redis 单个实例的详细信息。

名称	类型	说明
isMaster	boolean	指定实例是否为主节点。
isPrimary	boolean	指定实例是否为主节点。
nonSslPort	integer (int32)	如果 enableNonSslPort 为 true，请提供 Redis 实例非 SSL 端口。
shardId	integer (int32)	如果启用了群集，则 Redis 实例的分片 ID
sslPort	integer (int32)	Redis 实例 SSL 端口。
zone	string	如果缓存使用可用性区域，则指定此实例所在的可用性区域。

RedisLinkedServer

Object

链接服务器 ID

名称	类型	说明
id	string	链接服务器 ID。

RedisResource

Object

列表或获取操作中的单个 Redis 项。

名称	类型	默认值	说明
disableAccessKeyAuthentication	boolean	False	如果设置为 true，则会禁用通过访问密钥向 Redis 进行身份验证。默认值为 false。
enableNonSslPort	boolean	False	指定是否启用非 ssl Redis 服务器端口（6379）。
id	string (arm-id)		资源的完全限定资源 ID。例如，“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
identity	ManagedServiceIdentity		分配给此资源的托管服务标识。
location	string		资源所在的地理位置
minimumTlsVersion	TlsVersion		可选：要求客户端使用指定的 TLS 版本（或更高版本）进行连接（例如，“1.0”、“1.1”、“1.2”）
name	string		资源的名称
properties.accessKeys	RedisAccessKeys		Redis 缓存的键 - 如果此对象不是创建或更新 redis 缓存的响应，则不设置
properties.hostName	string		Redis 主机名。
properties.instances	RedisInstanceDetails[]		与缓存关联的 Redis 实例列表
properties.linkedServers	RedisLinkedServer[]		与缓存关联的链接服务器列表
properties.port	integer (int32)		Redis 非 SSL 端口。
properties.privateEndpointConnections	PrivateEndpointConnection[]		与指定的 redis 缓存关联的专用终结点连接列表
properties.provisioningState	ProvisioningState		Redis 实例预配状态。
properties.sku	Sku		要部署的 Redis 缓存的 SKU。
properties.sslPort	integer (int32)		Redis SSL 端口。
properties.staticIP	string pattern: ^\d+\.\d+\.\d+\.\d+$		静态 IP 地址。（可选）在现有 Azure 虚拟网络中部署 Redis 缓存时可以指定;默认情况下自动分配。
properties.subnetId	string pattern: ^/subscriptions/[^/]/resourceGroups/[^/]/providers/Microsoft.(ClassicNetwork\|Network)/virtualNetworks/[^/]/subnets/[^/]$		要在其中部署 Redis 缓存的虚拟网络中子网的完整资源 ID。示例格式：/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft。{Network\|ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1
publicNetworkAccess	PublicNetworkAccess		是否允许对此缓存使用公共终结点访问。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”。如果为“Disabled”，则专用终结点是独占访问方法。
redisConfiguration	RedisCommonPropertiesRedisConfiguration		所有 Redis 设置。很少有可能的密钥：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 等。
redisVersion	string		Redis 版本。这应采用“major[.minor]”（仅需要“major”）或值“latest”，该值引用可用的最新稳定 Redis 版本。支持的版本：4.0、6.0（最新版）。默认值为“latest”。
replicasPerMaster	integer (int32)		要为每个主要副本创建的副本数。
replicasPerPrimary	integer (int32)		要为每个主要副本创建的副本数。
shardCount	integer (int32)		在高级群集缓存上创建的分片数。
systemData	systemData		包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags	object		资源标记。
tenantSettings	object		租户设置字典
type	string		资源的类型。例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”
updateChannel	UpdateChannel		可选：指定 Redis 缓存将接收的每月 Redis 更新的更新通道。使用“预览”更新通道的缓存在“稳定”通道缓存之前至少提前 4 周获取最新的 Redis 更新。默认值为“Stable”。
zonalAllocationPolicy	ZonalAllocationPolicy		可选：指定如何将可用性区域分配给 Redis 缓存。 “自动”启用区域冗余，Azure 将根据区域可用性和容量自动选择区域。 “UserDefined”将使用“zone”参数选择传入的可用性区域。 “NoZones”将生成非区域性缓存。如果未传递“zonalAllocationPolicy”，则会在传入区域时将其设置为“UserDefined”，否则，在不支持区域的区域中，将设置为“自动”，在不支持区域的区域中将其设置为“NoZones”。
zones	string[]		可用性区域。

RedisUpdateParameters

Object

提供给 Update Redis 操作的参数。

名称	类型	默认值	说明
identity	ManagedServiceIdentity		资源的标识。
properties.disableAccessKeyAuthentication	boolean	False	如果设置为 true，则会禁用通过访问密钥向 Redis 进行身份验证。默认值为 false。
properties.enableNonSslPort	boolean	False	指定是否启用非 ssl Redis 服务器端口（6379）。
properties.minimumTlsVersion	TlsVersion		可选：要求客户端使用指定的 TLS 版本（或更高版本）进行连接（例如，“1.0”、“1.1”、“1.2”）
properties.publicNetworkAccess	PublicNetworkAccess		是否允许对此缓存使用公共终结点访问。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”。如果为“Disabled”，则专用终结点是独占访问方法。
properties.redisConfiguration	RedisCommonPropertiesRedisConfiguration		所有 Redis 设置。很少有可能的密钥：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 等。
properties.redisVersion	string		Redis 版本。这应采用“major[.minor]”（仅需要“major”）或值“latest”，该值引用可用的最新稳定 Redis 版本。支持的版本：4.0、6.0（最新版）。默认值为“latest”。
properties.replicasPerMaster	integer (int32)		要为每个主要副本创建的副本数。
properties.replicasPerPrimary	integer (int32)		要为每个主要副本创建的副本数。
properties.shardCount	integer (int32)		在高级群集缓存上创建的分片数。
properties.sku	Sku		要部署的 Redis 缓存的 SKU。
properties.tenantSettings	object		租户设置字典
properties.updateChannel	UpdateChannel		可选：指定 Redis 缓存将接收的每月 Redis 更新的更新通道。使用“预览”更新通道的缓存在“稳定”通道缓存之前至少提前 4 周获取最新的 Redis 更新。默认值为“Stable”。
properties.zonalAllocationPolicy	ZonalAllocationPolicy		可选：指定如何将可用性区域分配给 Redis 缓存。 “自动”启用区域冗余，Azure 将根据区域可用性和容量自动选择区域。 “UserDefined”将使用“zone”参数选择传入的可用性区域。 “NoZones”将生成非区域性缓存。如果未传递“zonalAllocationPolicy”，则会在传入区域时将其设置为“UserDefined”，否则，在不支持区域的区域中，将设置为“自动”，在不支持区域的区域中将其设置为“NoZones”。
tags	object		资源标记。

Sku

Object

提供给创建 Redis 操作的 SKU 参数。

名称	类型	说明
capacity	integer (int32)	要部署的 Redis 缓存的大小。有效值：对于 C（基本/标准）系列（0、1、2、3、4、5、6）、P（高级）系列（1、2、3、4）。
family	SkuFamily	要使用的 SKU 系列。有效值：（C、P）。（C = 基本/标准，P = 高级）。
name	SkuName	要部署的 Redis 缓存的类型。有效值：（基本、标准、高级）

SkuFamily

枚举

要使用的 SKU 系列。有效值：（C、P）。（C = 基本/标准，P = 高级）。

值	说明
C	要使用的 SKU 系列 - 对于基本/标准 SKU redis 缓存，必须为“C”。
P	要使用的 SKU 系列 - 对于高级 SKU redis 缓存，必须为“P”。

SkuName

枚举

要部署的 Redis 缓存的类型。有效值：（基本、标准、高级）

值	说明
Basic	Azure Cache for Redis 的众所周知的“基本”SKU。基本 SKU 没有可用性 SLA。
Standard	Azure Cache for Redis 的众所周知的“标准”SKU。标准 SKU 具有可用性 SLA。
Premium	Azure Cache for Redis 的众所周知的“高级”SKU。与标准 SKU 相比，高级 SKU 具有可用性 SLA、更高的性能层和更多功能。

systemData

Object

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

TlsVersion

枚举

可选：要求客户端使用指定的 TLS 版本（或更高版本）进行连接（例如，“1.0”、“1.1”、“1.2”）

值	说明
1.0	TLS 协议版本 1.0 -- 出于安全原因已弃用。不要将此值用于新缓存。
1.1	TLS 协议版本 1.1 -- 出于安全原因已弃用。不要将此值用于新缓存。
1.2	TLS 协议版本 1.2 -- 对新缓存使用此值或更高值。或者不指定，以便缓存使用建议的默认值

UpdateChannel

枚举

可选：指定 Redis 缓存将接收的每月 Redis 更新的更新通道。使用“预览”更新通道的缓存在“稳定”通道缓存之前至少提前 4 周获取最新的 Redis 更新。默认值为“Stable”。

值	说明
Stable	稳定频道接收更新，其中可能包括重要的安全性和稳定性更新，晚于预览频道。
Preview	预览通道通常在稳定通道之前接收更新，并且是非生产工作负载的建议通道。

UserAssignedIdentity

Object

用户分配的标识属性

名称	类型	说明
clientId	string (uuid)	分配的标识的客户端 ID。
principalId	string (uuid)	已分配标识的主体 ID。

ZonalAllocationPolicy

枚举

可选：指定如何将可用性区域分配给 Redis 缓存。 “自动”启用区域冗余，Azure 将根据区域可用性和容量自动选择区域。 “UserDefined”将使用“zone”参数选择传入的可用性区域。 “NoZones”将生成非区域性缓存。如果未传递“zonalAllocationPolicy”，则会在传入区域时将其设置为“UserDefined”，否则，在不支持区域的区域中，将设置为“自动”，在不支持区域的区域中将其设置为“NoZones”。

值	说明
Automatic	将根据可用性和容量自动选择缓存的区域。
UserDefined	UserDefined 表示缓存的区域是使用 'zones' 属性手动配置的，并且不能自动选择。
NoZones	缓存不会使用多个可用性区域。

通过

Redis - Update

URI 参数

请求正文

响应

安全性

azure_auth

作用域

示例

RedisCacheUpdate

示例请求

示例响应

定义

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