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 參數

名稱	位於	必要	類型	Description
name	path	True	string	RedisResource 的名稱
resourceGroupName	path	True	string minLength: 1 maxLength: 90	資源群組的名稱。名稱不區分大小寫。
subscriptionId	path	True	string (uuid)	目標訂用帳戶的標識碼。此值必須是 UUID。
api-version	query	True	string minLength: 1	要用於這項作業的 API 版本。

要求本文

名稱	類型	Description
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-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' 會選取您使用 'zones' 參數傳入的可用性區域。 'NoZones' 會產生非區域性快取。如果未傳遞 'zonalAllocationPolicy'，當區域傳入時，它將會設定為 'UserDefined'，否則，它會在區域不支援的區域和區域不支援的區域 'NoZones' 中設定為 'Automatic'。
tags	object	資源標籤。

回應

名稱	類型	Description
200 OK	RedisResource	要求已成功。
202 Accepted	RedisResource	要求已接受進行處理，但尚未完成處理。標題 Location: string
Other Status Codes	ErrorResponse	未預期的錯誤回應。

名稱

類型

Description

200 OK

RedisResource

要求已成功。

202 Accepted

RedisResource

要求已接受進行處理，但尚未完成處理。

標題

Location: string

Other Status Codes

ErrorResponse

未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
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": {}
}

定義

名稱	Description
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-policy、notify-keyspace-events、aof-backup-enabled、aof-storage-connection-string-0、aof-storage-connection-string-1 等。
RedisInstanceDetails	Redis 單一實例的詳細數據。
RedisLinkedServer	連結的伺服器識別碼
RedisResource	List 或 Get Operation 中的單一 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' 會選取您使用 'zones' 參數傳入的可用性區域。 'NoZones' 會產生非區域性快取。如果未傳遞 'zonalAllocationPolicy'，當區域傳入時，它將會設定為 'UserDefined'，否則，它會在區域不支援的區域和區域不支援的區域 'NoZones' 中設定為 'Automatic'。

createdByType

列舉型別

建立資源的身分識別類型。

值	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

ManagedServiceIdentity

Object

受控服務識別（系統指派和/或使用者指派的身分識別）

名稱	類型	Description
principalId	string (uuid)	系統指派身分識別的服務主體標識碼。此屬性只會針對系統指派的身分識別提供。
tenantId	string (uuid)	系統指派身分識別的租用戶標識碼。此屬性只會針對系統指派的身分識別提供。
type	ManagedServiceIdentityType	受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned 身分識別與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。字典值可以是要求中的空白物件（{}）。

ManagedServiceIdentityType

列舉型別

受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。

值	Description
None
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned

PrivateEndpoint

Object

私人端點資源。

名稱	類型	Description
id	string	私人端點的ARM標識碼。

PrivateEndpointConnection

Object

私人端點聯機資源。

名稱	類型	Description
id	string (arm-id)	資源的完整資源標識碼。例如 “/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	資源的名稱
properties.groupIds	string[]	私人端點資源的群組標識碼。
properties.privateEndpoint	PrivateEndpoint	私人端點資源。
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	服務取用者與提供者之間連線狀態的相關信息集合。
properties.provisioningState	PrivateEndpointConnectionProvisioningState	私人端點聯機資源的布建狀態。
systemData	systemData	包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。
type	string	資源的型別。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

PrivateEndpointConnectionProvisioningState

列舉型別

目前的布建狀態。

值	Description
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

列舉型別

私人端點連線狀態。

值	Description
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Object

服務取用者與提供者之間連線狀態的相關信息集合。

名稱	類型	Description
actionsRequired	string	訊息，指出服務提供者上的變更是否需要取用者的任何更新。
description	string	核准/拒絕連線的原因。
status	PrivateEndpointServiceConnectionStatus	指出服務擁有者是否已核准/拒絕/移除連線。

ProvisioningState

列舉型別

Redis 實例布建狀態。

值	Description
Creating	建立作業正在進行中。
Deleting	刪除作業正在進行中。
Disabled	快取已停用，無法使用。
Failed	建立或更新等作業失敗。如果您無法建立快取，它將不會處於可用狀態，因此您應該刪除並重新建立它。
Linking	異地複寫連結正在進行中
Provisioning	作業正在進行中
RecoveringScaleFailure	擴展作業發生錯誤，且復原正在進行中。
Scaling	擴展作業正在進行中
Succeeded	最近一次操作順利完成
Unlinking	異地複寫取消連結正在進行中
Unprovisioning	快取可能正在停用
Updating	更新作業正在進行中。
ConfiguringAAD	AAD 設定更新作業正在進行中。

PublicNetworkAccess

列舉型別

是否允許此快取存取公用端點。值為選擇性值，但如果傳入，則必須是『Enabled』或 'Disabled'。如果為『Disabled』，私人端點就是獨佔存取方法。預設值為 'Enabled'

值	Description
Enabled	已啟用透過其公用 IP 位址存取快取的公用網際網路。連線可以使用任何網路路徑。
Disabled	透過其公用 IP 位址存取快取的公用網際網路會停用。必須使用透過私人端點建立連線。

RedisAccessKeys

Object

Redis 快取存取金鑰。

名稱	類型	Description
primaryKey	string	用戶端可用來向 Redis 快取進行驗證的目前主鍵。
secondaryKey	string	用戶端可用來向 Redis 快取進行驗證的目前次要金鑰。

RedisCommonPropertiesRedisConfiguration

Object

所有 Redis 設定。少數可能密鑰：rdb-backup-enabled、rdb-storage-connection-string、rdb-backup-frequency、maxmemory-policy、notify-keyspace-events、aof-backup-enabled、aof-storage-connection-string-0、aof-storage-connection-string-1 等。

名稱	類型	Description
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	保留給每個分區片段的 MB 值
maxmemory-delta	string	針對每個分區保留給非快取使用量的 MB 值，例如故障轉移。
maxmemory-policy	string	數據不符合記憶體限制時所使用的收回策略。
maxmemory-reserved	string	針對每個分區保留給非快取使用量的 MB 值，例如故障轉移。
notify-keyspace-events	string	應該監視的keyspace事件。
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 單一實例的詳細數據。

名稱	類型	Description
isMaster	boolean	指定實例是否為主要節點。
isPrimary	boolean	指定實例是否為主要節點。
nonSslPort	integer (int32)	如果 enableNonSslPort 為 true，請提供 Redis 實例非 SSL 埠。
shardId	integer (int32)	如果已啟用叢集，Redis 實例的分區標識符
sslPort	integer (int32)	Redis 實例 SSL 埠。
zone	string	如果快取使用可用性區域，請指定這個實例所在的可用性區域。

RedisLinkedServer

Object

連結的伺服器識別碼

名稱	類型	Description
id	string	連結的伺服器識別碼。

RedisResource

Object

List 或 Get Operation 中的單一 Redis 專案。

名稱	類型	預設值	Description
disableAccessKeyAuthentication	boolean	False	當設定為 true 時，會停用透過存取密鑰對 Redis 的驗證。默認值為 false。
enableNonSslPort	boolean	False	指定是否啟用非 ssl Redis 伺服器埠（6379）。
id	string (arm-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 快取之子網的完整資源識別碼。範例格式：/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-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 Resource Manager 元數據。
tags	object		資源標籤。
tenantSettings	object		租用戶設定的字典
type	string		資源的型別。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”
updateChannel	UpdateChannel		選擇性：指定您 Redis 快取將接收之每月 Redis 更新的更新通道。使用「預覽」更新通道的快取，至少比「穩定」通道快取提前 4 周取得最新的 Redis 更新。默認值為『Stable』。
zonalAllocationPolicy	ZonalAllocationPolicy		選擇性：指定可用性區域如何配置給 Redis 快取。「自動」可啟用區域備援，Azure 會根據區域可用性和容量自動選取區域。 'UserDefined' 會選取您使用 'zones' 參數傳入的可用性區域。 'NoZones' 會產生非區域性快取。如果未傳遞 'zonalAllocationPolicy'，當區域傳入時，它將會設定為 'UserDefined'，否則，它會在區域不支援的區域和區域不支援的區域 'NoZones' 中設定為 'Automatic'。
zones	string[]		可用性區域。

RedisUpdateParameters

Object

提供給 Update Redis 作業的參數。

名稱	類型	預設值	Description
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-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' 會選取您使用 'zones' 參數傳入的可用性區域。 'NoZones' 會產生非區域性快取。如果未傳遞 'zonalAllocationPolicy'，當區域傳入時，它將會設定為 'UserDefined'，否則，它會在區域不支援的區域和區域不支援的區域 'NoZones' 中設定為 'Automatic'。
tags	object		資源標籤。

Sku

Object

提供給建立 Redis 作業的 SKU 參數。

名稱	類型	Description
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 = 進階）。

值	Description
C	要使用的 SKU 系列 - 對於基本/標準 SKU redis 快取，必須是 'C'。
P	要使用的 SKU 系列 - 對於進階 SKU redis 快取，必須是 'P'。

SkuName

列舉型別

要部署的 Redis 快取類型。有效值：（基本、標準、進階）

值	Description
Basic	適用於 Redis 的 Azure 快取的眾所周知的「基本」SKU。基本 SKU 沒有可用性 SLA。
Standard	適用於 Redis 的 Azure 快取的眾所周知的「標準」SKU。標準 SKU 具有可用性 SLA。
Premium	適用於 Redis 的 Azure 快取的眾所周知的「進階」SKU。與標準 SKU 相比，進階 SKU 具有可用性 SLA，以及更高的效能層和更多功能。

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
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'）

值	Description
1.0	TLS 通訊協定 1.0 版 -- 基於安全原因已淘汰。請勿將此值用於新快取。
1.1	TLS 通訊協定 1.1 版 -- 基於安全理由已淘汰。請勿將此值用於新快取。
1.2	TLS 通訊協定 1.2 版 -- 針對新快取使用此值或更高值。或者不要指定，以便快取使用建議的預設值

UpdateChannel

列舉型別

選擇性：指定您 Redis 快取將接收之每月 Redis 更新的更新通道。使用「預覽」更新通道的快取，至少比「穩定」通道快取提前 4 周取得最新的 Redis 更新。默認值為『Stable』。

值	Description
Stable	穩定頻道會晚於預覽頻道接收更新，其中可能包括重要的安全性和穩定性更新。
Preview	預覽通道通常會在穩定通道之前接收更新，而且是非生產工作負載的建議通道。

UserAssignedIdentity

Object

使用者指派的身分識別屬性

名稱	類型	Description
clientId	string (uuid)	指派之身分識別的用戶端標識碼。
principalId	string (uuid)	指派之身分識別的主體標識碼。

ZonalAllocationPolicy

列舉型別

選擇性：指定可用性區域如何配置給 Redis 快取。「自動」可啟用區域備援，Azure 會根據區域可用性和容量自動選取區域。 'UserDefined' 會選取您使用 'zones' 參數傳入的可用性區域。 'NoZones' 會產生非區域性快取。如果未傳遞 'zonalAllocationPolicy'，當區域傳入時，它將會設定為 'UserDefined'，否則，它會在區域不支援的區域和區域不支援的區域 'NoZones' 中設定為 'Automatic'。

值	Description
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