az redis

管理 Azure 應用程式的專用 Redis 快取。

命令

名稱	Description	類型	狀態
az redis access-policy	管理 Redis 快取的存取原則。	核心	加語
az redis access-policy-assignment	管理 Redis 快取的存取原則指派（Redis 使用者）。	核心	加語
az redis access-policy-assignment create	將存取原則指派 （Redis 使用者） 新增至 Redis 快取。	核心	加語
az redis access-policy-assignment delete	刪除存取原則指派（Redis 使用者）。	核心	加語
az redis access-policy-assignment list	取得與 Redis 快取相關聯的存取原則指派清單（Redis 使用者）。	核心	加語
az redis access-policy-assignment show	取得 Redis 快取之存取原則指派 （Redis 使用者） 的詳細資訊。	核心	加語
az redis access-policy-assignment update	更新 Redis 快取的存取原則指派 （Redis 使用者）。	核心	加語
az redis access-policy create	將存取原則新增至 Redis 快取。	核心	加語
az redis access-policy delete	刪除存取原則。	核心	加語
az redis access-policy list	取得與 Redis 快取相關聯的存取原則清單。	核心	加語
az redis access-policy show	取得 Redis 快取存取原則的詳細資訊。	核心	加語
az redis access-policy update	更新 Redis 快取的存取原則。	核心	加語
az redis create	建立新的 Redis 快取實例。	核心	加語
az redis delete	刪除 Redis 快取。	核心	加語
az redis export	匯出儲存在 Redis 快取中的數據。	核心	加語
az redis firewall-rules	管理 Redis 防火牆規則。	核心	加語
az redis firewall-rules create	建立 redis 快取防火牆規則。	核心	加語
az redis firewall-rules delete	刪除指定 redis 快取中的單一防火牆規則。	核心	加語
az redis firewall-rules list	取得指定 redis 快取中的所有防火牆規則。	核心	加語
az redis firewall-rules show	取得指定 redis 快取中的單一防火牆規則。	核心	加語
az redis firewall-rules update	更新 redis 快取防火牆規則。	核心	加語
az redis flush	刪除快取中的所有索引鍵。	核心	加語
az redis force-reboot	重新啟動指定的 Redis 節點（s）。	核心	加語
az redis identity	管理指派給 Azure Cache for Redis 的身分識別。	核心	加語
az redis identity assign	指派 Azure Cache for Redis 的身分識別。	核心	加語
az redis identity remove	拿掉已為 Azure Cache for Redis 指派的身分識別。	核心	加語
az redis identity show	顯示為 Azure Cache for Redis 指派的身分識別。	核心	加語
az redis import	將數據匯入 Redis 快取。	核心	加語
az redis import-method	將數據匯入 Redis 快取。	核心	荒廢的
az redis list	列出 Redis 快取。	核心	加語
az redis list-keys	擷取 Redis 快取的存取金鑰。	核心	加語
az redis patch-schedule	管理 Redis 修補程式排程。	核心	加語
az redis patch-schedule create	建立 Redis 快取的修補排程。	核心	加語
az redis patch-schedule delete	刪除 redis 快取的修補排程。	核心	加語
az redis patch-schedule show	取得 redis 快取的修補排程。	核心	加語
az redis patch-schedule update	更新 Redis 快取的修補排程。	核心	加語
az redis regenerate-keys	重新產生 Redis 快取的存取金鑰。	核心	加語
az redis server-link	管理 Redis 伺服器連結。	核心	加語
az redis server-link create	將伺服器連結新增至 Redis 快取（需要進階 SKU）。	核心	加語
az redis server-link delete	從 Redis 快取中刪除連結的伺服器（需要進階 SKU）。	核心	加語
az redis server-link list	取得與此 redis 快取相關聯的連結伺服器清單（需要進階 SKU）。	核心	加語
az redis server-link show	取得 Redis 快取連結伺服器的詳細資訊（需要進階 SKU）。	核心	加語
az redis show	取得 Redis 快取 （資源描述）。	核心	加語
az redis update	更新 Redis 快取。	核心	加語

az redis create

建立新的 Redis 快取實例。

az redis create --location
                --name
                --resource-group
                --sku {Basic, Premium, Standard}
                --vm-size {c0, c1, c2, c3, c4, c5, c6, p1, p2, p3, p4, p5}
                [--disable-access-keys {false, true}]
                [--enable-non-ssl-port]
                [--mi-system-assigned]
                [--mi-user-assigned]
                [--minimum-tls-version {1.0, 1.1, 1.2}]
                [--redis-configuration]
                [--redis-version]
                [--replicas-per-master]
                [--shard-count]
                [--static-ip]
                [--subnet-id]
                [--tags]
                [--tenant-settings]
                [--update-channel {Preview, Stable}]
                [--zonal-allocation {Automatic, NoZones, UserDefined}]
                [--zones]

範例

建立新的 Redis 快取實例。 （ 自動產生 ）

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Basic --vm-size c0

為新的進階 Azure Redis 快取設定多個區域

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Premium --vm-size p1 --zones 1 2

部署已自動配置區域的進階 Azure Cache for Redis

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Premium --vm-size p1 --zonal-allocation-policy Automatic

設定快取的記憶體原則。

az redis create --resource-group resourceGroupName --name cacheName --location westus2 --sku Standard --vm-size c0 --redis-configuration @"config_max-memory.json"

為新的進階 Azure Redis 快取設定並啟用 RDB 備份數據持續性。

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Premium --vm-size p1 --redis-configuration @"config_rdb.json"

為新的進階 Azure Redis 快取設定並啟用 AOF 備份數據持續性

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Premium --vm-size p1 --redis-configuration @"config_aof.json"

建立已啟用叢集功能的進階 Azure Redis 快取

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Premium --vm-size p1 --shard-count 2

在現有的 Azure 虛擬網路內部署進階 Azure Cache for Redis

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Premium --vm-size p1 --subnet-id "/subscriptions/{subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.{Network|ClassicNetwork}/virtualNetworks/vnet1/subnets/subnet1"

部署進階 Azure Cache for Redis，並已設定 Microsoft Entra Authentication 並停用存取密鑰

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Premium --vm-size p1 --disable-access-keys true --redis-configuration @"config_enable-aad.json"

必要參數

--location -l

位置。 來自的值：az account list-locations。 您可以使用 az configure --defaults location=<location>來設定預設位置。

--name -n

Redis 快取的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--sku

Redis 快取的類型。

接受的值: Basic, Premium, Standard

--vm-size

要部署的 Redis 快取大小。 基本和標準快取大小從 C 開始。進階快取大小從 P 開始。

接受的值: c0, c1, c2, c3, c4, c5, c6, p1, p2, p3, p4, p5

選擇性參數

--disable-access-keys

當設定為 true 時，會停用透過存取密鑰對 Redis 的驗證。

接受的值: false, true

--enable-non-ssl-port

如果指定，則會啟用非 ssl redis 伺服器埠 （6379）。

--mi-system-assigned

指定系統指派身分識別的旗標。

--mi-user-assigned

使用者指派身分識別的一或多個空間分隔資源標識符。

--minimum-tls-version

指定客戶端連線至快取所需的 TLS 版本。

接受的值: 1.0, 1.1, 1.2

--redis-configuration

用來設定 redis 組態設定的 json 檔案。 如果 json 檔案無效，您可能會遇到剖析錯誤。

使用量：--redis-configuration @"{config_file.json}"

設定 max-memory policies 的範例 json 檔案 [ { “maxmemory-policy”： “allkeys-lru” } ]

啟用 RDB 備份數據持續性的範例 json 檔案是 [ { “rdb-storage-connection-string”： “DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=myAccountKey;EndpointSuffix=core.windows.net“， ”rdb-backup-enabled“： ”true“， ”rdb-backup-frequency“： ”15“， ”rdb-backup-max-snapshot-count“： ”1“ } ]

啟用 AOF 備份數據持續性的範例 json 檔案是 [ { “aof-backup-enabled”： “true”， “aof-storage-connection-string-0”： “DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=myAccountKey;EndpointSuffix=core.windows.net“， ”aof-storage-connection-string-1“： ”DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=myAccountKey;EndpointSuffix=core.windows.net“ } ]

用於設定 Microsoft Entra Authentication 的 json 檔案內容為 { “aad-enabled”： “true”， }。

--redis-version

Redis 版本。 這的格式應該是 'major[.minor]' （只需要 'major' ）或值 'latest'，其指的是可用的最新穩定 Redis 版本。 支援的版本：4.0、6.0（最新版）。 預設值為 『latest』。

--replicas-per-master

要為每個主要複本建立的複本數目。

--shard-count

在進階叢集快取上建立的分區數目。

--static-ip

如果需要 VNET，請指定靜態 IP。 如果您未指定靜態IP，則會自動選擇IP位址。

--subnet-id

虛擬網路中要部署 redis 快取之子網的完整資源標識碼。 範例格式 /subscriptions/{subid}/resourceGroups/{resourceGroupName}/providers/Microsoft。{Network|ClassicNetwork}/virtualNetworks/vnet1/subnets/subnet1。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--tenant-settings

key[=value] 格式的空間分隔租用戶設定。

--update-channel

指定您 Redis 快取將接收之每月 Redis 更新的更新通道。 使用「預覽」更新通道的快取會在「穩定」通道快取之前至少 4 周取得最新的 Redis 更新。 預設值為 「Stable」。

接受的值: Preview, Stable

--zonal-allocation --zonal-allocation-policy

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

接受的值: Automatic, NoZones, UserDefined

--zones -z

要在其中布建資源的可用性區域空間分隔清單。

全域參數

--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az redis delete

刪除 Redis 快取。

az redis delete [--ids]
                [--name]
                [--resource-group]
                [--subscription]
                [--yes]

選擇性參數

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

Redis 快取的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--yes -y

請勿提示確認。

預設值: False

全域參數

--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az redis export

匯出儲存在 Redis 快取中的數據。

az redis export --container
                --prefix
                [--auth-method {ManagedIdentity, SAS}]
                [--file-format]
                [--ids]
                [--name]
                [--resource-group]
                [--storage-sub-id]
                [--subscription]

範例

使用受控識別導出快取數據

az redis export -n testCacheName -g testResourceGroup --prefix examplePrefix --container containerUrl  --preferred-data-archive-auth-method ManagedIdentity --storage-subscription-id 1a6574ss-ddad-1111-a111-8d756312d1dd

必要參數

--container

需要匯出數據之容器的SAS URL。

--prefix

要用於導出檔案的前置詞。

選擇性參數

--auth-method --preferred-data-archive-auth-method

慣用的驗證方法，用來與用於數據封存的記憶體帳戶通訊，預設值為 SAS。

接受的值: ManagedIdentity, SAS

--file-format

Blob 的格式（目前 rdb 是唯一支援的格式，未來預期使用其他格式）。

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

Redis 快取的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--storage-sub-id --storage-subscription-id

記憶體帳戶的 SubscriptionId。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az redis flush

刪除快取中的所有索引鍵。

az redis flush [--ids]
               [--name]
               [--resource-group]
               [--subscription]
               [--yes]

選擇性參數

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

Redis 快取的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--yes -y

請勿提示確認。

預設值: False

全域參數

--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az redis force-reboot

重新啟動指定的 Redis 節點（s）。

使用範例 - az redis force-reboot --name testCacheName --resource-group testResourceGroup --reboot-type {AllNodes， PrimaryNode， SecondaryNode} [--shard-id]。

az redis force-reboot --reboot-type {AllNodes, PrimaryNode, SecondaryNode}
                      [--ids]
                      [--name]
                      [--resource-group]
                      [--shard-id]
                      [--subscription]

必要參數

--reboot-type

要重新啟動的 Redis 節點。 視此值而定，可能會遺失數據。

接受的值: AllNodes, PrimaryNode, SecondaryNode

選擇性參數

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

Redis 快取的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--shard-id

如果已啟用叢集，則會重新啟動分區的標識碼。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az redis import

將數據匯入 Redis 快取。

az redis import --files
                [--auth-method {ManagedIdentity, SAS}]
                [--file-format]
                [--ids]
                [--name]
                [--resource-group]
                [--storage-sub-id]
                [--subscription]

範例

使用受控識別匯入快取數據

az redis import -n testCacheName -g testResourceGroup --files blobUrl --preferred-data-archive-auth-method ManagedIdentity --storage-subscription-id 1a6574ss-ddad-1111-a111-8d756312d1dd

必要參數

--files

需要匯入之 Blob 的 SAS URL。

選擇性參數

--auth-method --preferred-data-archive-auth-method

慣用的驗證方法，用來與用於數據封存的記憶體帳戶通訊，預設值為 SAS。

接受的值: ManagedIdentity, SAS

--file-format

Blob 的格式（目前 rdb 是唯一支援的格式，未來預期使用其他格式）。

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

Redis 快取的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--storage-sub-id --storage-subscription-id

記憶體帳戶的 SubscriptionId。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az redis import-method

已被取代

此命令已被取代，並將在未來版本中移除。 請改用 『redis import』。

將數據匯入 Redis 快取。

使用範例 - az redis import-method --name testCacheName --resource-group testResourceGroup --files [--file-format]。

az redis import-method --files
                       [--auth-method {ManagedIdentity, SAS}]
                       [--file-format]
                       [--ids]
                       [--name]
                       [--resource-group]
                       [--storage-sub-id]
                       [--subscription]

必要參數

--files

需要匯入之 Blob 的 SAS URL。

選擇性參數

--auth-method --preferred-data-archive-auth-method

慣用的驗證方法，用來與用於數據封存的記憶體帳戶通訊，預設值為 SAS。

接受的值: ManagedIdentity, SAS

--file-format

Blob 的格式（目前 rdb 是唯一支援的格式，未來預期使用其他格式）。

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

Redis 快取的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--storage-sub-id --storage-subscription-id

記憶體帳戶的 SubscriptionId。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az redis list

列出 Redis 快取。

列出目前訂用帳戶內或提供之資源群組內所有快取的詳細數據。

az redis list [--resource-group]

選擇性參數

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

全域參數

--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az redis list-keys

擷取 Redis 快取的存取金鑰。

此作業需要快取資源的寫入許可權。

az redis list-keys [--ids]
                   [--name]
                   [--resource-group]
                   [--subscription]

選擇性參數

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

Redis 快取的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az redis regenerate-keys

重新產生 Redis 快取的存取金鑰。

使用範例 - az redis regenerate-keys --name testCacheName --resource-group testResourceGroup --key-type {Primary， Secondary}。

az redis regenerate-keys --key-type {Primary, Secondary}
                         [--ids]
                         [--name]
                         [--resource-group]
                         [--subscription]

必要參數

--key-type

要重新產生之 Redis 存取金鑰。

接受的值: Primary, Secondary

選擇性參數

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

Redis 快取的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az redis show

取得 Redis 快取 （資源描述）。

az redis show [--ids]
              [--name]
              [--resource-group]
              [--subscription]

選擇性參數

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

Redis 快取的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az redis update

更新 Redis 快取。

調整或更新 Redis 快取的設定。

az redis update [--add]
                [--force-string]
                [--ids]
                [--name]
                [--no-wait {false, true}]
                [--remove]
                [--resource-group]
                [--set]
                [--sku {Basic, Premium, Standard}]
                [--subscription]
                [--vm-size {c0, c1, c2, c3, c4, c5, c6, p1, p2, p3, p4, p5}]

範例

更新名為 MyRedisCache 之 Azure Cache for Redis 的 maxmemory-policy

az redis update --name MyRedisCache --resource-group MyResourceGroup --set "redisConfiguration.maxmemory-policy"="allkeys-lru"

停用進階 Azure Cache for Redis 的 RDB 備份數據持續性

az redis update --name MyRedisCache --resource-group MyResourceGroup --set "redisConfiguration.rdb-backup-enabled"="false"

針對已建立的進階 Azure Cache for Redis 設定已啟用 RDB 備份的數據持續性

az redis update --name MyRedisCache --resource-group MyResourceGroup --set "redisConfiguration.rdb-storage-connection-string"="BlobEndpoint=https//..." "redisConfiguration.rdb-backup-enabled"="true" "redisConfiguration.rdb-backup-frequency"="15" "redisConfiguration.rdb-backup-max-snapshot-count"="1"

調整 Azure Cache for Redis 實例 - 更新為不同的大小（從 c0 調整為 c1 的範例）。

az redis update --name MyRedisCache --resource-group MyResourceGroup --set "sku.capacity"="2"

調整 Azure Cache for Redis 實例 - 將更新至不同層級（從基本層調整為標準或標準至進階版）。

az redis update --name MyRedisCache --resource-group MyResourceGroup --set "sku.name"="Premium" "sku.capacity"="1" "sku.family"="P"

調整 Azure Cache for Redis 實例 - 啟用叢集。

az redis update --name MyRedisCache --resource-group MyResourceGroup --set shardCount=1

使用 Redis 叢集來相應縮小/放大 Azure Cache for Redis 實例。

az redis update --name MyRedisCache --resource-group MyResourceGroup --set shardCount=2

停用 Redis 的存取金鑰驗證。

az redis update --name MyRedisCache --resource-group MyResourceGroup --set "disableAccessKeyAuthentication=true"

使用自動區域配置原則，將非區域備援快取更新至區域備援快取。

az redis update --name MyRedisCache --resource-group MyResourceGroup --set "zonalAllocationPolicy=Automatic"

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例：--add property.listProperty <key=value, string or JSON string>。

預設值: []

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

預設值: False

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

Redis 快取的名稱。

--no-wait

已被取代

自變數 'no_wait' 已被取代，並將在未來版本中移除。

將 指定為 false 以等候長時間執行作業的結果。

接受的值: false, true

--remove

從清單中移除屬性或專案。 範例：--remove property.list <indexToRemove> OR --remove propertyToRemove。

預設值: []

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--set

指定要設定的屬性路徑和值，以更新物件。 範例：--set property1.property2=<value>。

預設值: []

--sku

Redis 快取的類型。

接受的值: Basic, Premium, Standard

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--vm-size

要部署的 Redis 快取大小。 基本和標準快取大小從 C 開始。進階快取大小從 P 開始。

接受的值: c0, c1, c2, c3, c4, c5, c6, p1, p2, p3, p4, p5

全域參數

--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。