az hpc-cache

注意

此參考是 Azure CLI 的 hpc-cache 擴充功能的一部分 （2.3.0 版或更高版本）。 擴充功能會在您第一次執行 az hpc-cache 命令時自動安裝。 深入了解擴充功能。

管理 hpc cache 的命令。

命令

名稱	Description	類型	狀態
az hpc-cache blob-storage-target	建立 hpc cache Blob 儲存體目標的命令。	擴充	GA
az hpc-cache blob-storage-target add	建立或更新目標儲存體 Blob。 您可以隨時允許此作業，但如果快取關閉或狀況不良，則儲存體目標的實際建立/修改可能會延遲，直到快取再次狀況良好為止。	擴充	GA
az hpc-cache blob-storage-target update	建立或更新目標儲存體 Blob。 您可以隨時允許此作業，但如果快取關閉或狀況不良，則儲存體目標的實際建立/修改可能會延遲，直到快取再次狀況良好為止。	擴充	GA
az hpc-cache create	建立或更新快取。	擴充	GA
az hpc-cache delete	排程要刪除的快取。	擴充	GA
az hpc-cache flush	告訴快取將所有髒資料寫入儲存體目標。 在排清期間，用戶端會看到傳回的錯誤，直到排清完成為止。	擴充	GA
az hpc-cache list	傳回使用者有權存取資源群組下的所有快取。	擴充	GA
az hpc-cache nfs-storage-target	建立 hpc cache nfs 儲存體目標的命令。	擴充	GA
az hpc-cache nfs-storage-target add	建立或更新 nfs 儲存體 Target。 您可以隨時允許此作業，但如果快取關閉或狀況不良，則儲存體目標的實際建立/修改可能會延遲，直到快取再次狀況良好為止。	擴充	GA
az hpc-cache nfs-storage-target update	建立或更新 nfs 儲存體 Target。 您可以隨時允許此作業，但如果快取關閉或狀況不良，則儲存體目標的實際建立/修改可能會延遲，直到快取再次狀況良好為止。	擴充	GA
az hpc-cache show	傳回快取。	擴充	GA
az hpc-cache skus	管理 hpc cache sku 的命令。	擴充	GA
az hpc-cache skus list	取得此訂用帳戶可用的 儲存體Cache.Cache SKU 清單。	擴充	GA
az hpc-cache start	告知已停止狀態快取轉換為作用中狀態。	擴充	GA
az hpc-cache stop	告知作用中快取轉換為已停止狀態。	擴充	GA
az hpc-cache storage-target	管理 hpc cache storage target 的命令。	擴充	GA
az hpc-cache storage-target list	傳回指定快取儲存體目標的清單。	擴充	GA
az hpc-cache storage-target remove	從快取中移除儲存體目標。 您可以隨時允許此作業，但如果快取關閉或狀況不良，則實際移除儲存體目標可能會延遲，直到快取再次狀況良好為止。 請注意，如果快取有資料要排清至儲存體目標，則會先排清資料，再刪除儲存體目標。	擴充	GA
az hpc-cache storage-target show	從快取傳回儲存體目標。	擴充	GA
az hpc-cache update	更新快取。	擴充	GA
az hpc-cache upgrade-firmware	如果有新版本可用，請升級快取的韌體。 否則，此作業不會有任何作用。	擴充	GA
az hpc-cache usage-model	管理 hpc cache 使用量模型的命令。	擴充	GA
az hpc-cache usage-model list	取得此訂用帳戶可用的快取使用模型清單。	擴充	GA
az hpc-cache wait	等候 hpc Cache 至指定的狀態。	擴充	GA

az hpc-cache create

建立或更新快取。

az hpc-cache create --cache-size-gb
                    --location
                    --name
                    --resource-group
                    --sku-name
                    --subnet
                    [--no-wait]
                    [--tags]

範例

Caches_CreateOrUpdate

az hpc-cache create --resource-group "scgroup" --name "sc1" --location "eastus" --cache-size-gb "3072" --subnet "/subscriptions/{subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.Network/virtualNetworks/{virtual_network_name}/subnets/{subnet_name}" --sku-name "Standard_2G"

必要參數

--cache-size-gb

此快取的大小，以 GB 為單位。

--location -l

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

--name

快取的名稱。

--resource-group -g

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

--sku-name

此快取的 SKU 名稱。

--subnet

用於快取的子網。

選擇性參數

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--tags

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

全域參數

--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 hpc-cache delete

排程要刪除的快取。

az hpc-cache delete --name
                    --resource-group
                    [--no-wait]

範例

Caches_Delete

az hpc-cache delete --resource-group "scgroup" --name "sc"

必要參數

--name

快取的名稱。

--resource-group -g

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

選擇性參數

--no-wait

請勿等候長時間執行的作業完成。

預設值: 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 hpc-cache flush

告訴快取將所有髒資料寫入儲存體目標。 在排清期間，用戶端會看到傳回的錯誤，直到排清完成為止。

az hpc-cache flush --name
                   --resource-group

範例

Caches_Flush

az hpc-cache flush --resource-group "scgroup" --name "sc"

必要參數

--name

快取的名稱。

--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 hpc-cache list

傳回使用者有權存取資源群組下的所有快取。

az hpc-cache list [--resource-group]

範例

Caches_List

az hpc-cache list

Caches_ListByResourceGroup

az hpc-cache list --resource-group "scgroup"

選擇性參數

--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 hpc-cache show

傳回快取。

az hpc-cache show --name
                  --resource-group

範例

Caches_Get

az hpc-cache show --resource-group "scgroup" --name "sc1"

必要參數

--name

快取的名稱。

--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 hpc-cache start

告知已停止狀態快取轉換為作用中狀態。

az hpc-cache start --name
                   --resource-group
                   [--no-wait]

範例

Caches_Start

az hpc-cache start --resource-group "scgroup" --name "sc"

必要參數

--name

快取的名稱。

--resource-group -g

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

選擇性參數

--no-wait

請勿等候長時間執行的作業完成。

預設值: 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 hpc-cache stop

告知作用中快取轉換為已停止狀態。

az hpc-cache stop --name
                  --resource-group
                  [--no-wait]

範例

Caches_Stop

az hpc-cache stop --resource-group "scgroup" --name "sc"

必要參數

--name

快取的名稱。

--resource-group -g

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

選擇性參數

--no-wait

請勿等候長時間執行的作業完成。

預設值: 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 hpc-cache update

更新快取。

az hpc-cache update --name
                    --resource-group
                    [--tags]

範例

Caches_Update

az hpc-cache update --resource-group "scgroup" --name "sc1" --tags "key=val"

必要參數

--name

快取的名稱。

--resource-group -g

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

選擇性參數

--tags

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

全域參數

--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 hpc-cache upgrade-firmware

如果有新版本可用，請升級快取的韌體。 否則，此作業不會有任何作用。

az hpc-cache upgrade-firmware --name
                              --resource-group

範例

Caches_UpgradeFirmware

az hpc-cache upgrade-firmware --resource-group "scgroup" --name "sc"

必要參數

--name

快取的名稱。

--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 hpc-cache wait

等候 hpc Cache 至指定的狀態。

az hpc-cache wait --name
                  --resource-group
                  [--created]
                  [--custom]
                  [--deleted]
                  [--exists]
                  [--interval]
                  [--timeout]
                  [--updated]

範例

Caches_Wait

az hpc-cache wait --resource-group "scgroup" --name "sc" --created

必要參數

--name -n

快取的名稱。

--resource-group -g

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

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False

--custom

等到條件符合自訂 JMESPath 查詢為止。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False

--exists

等候資源存在。

預設值: False

--interval

輪詢間隔以秒為單位。

預設值: 30

--timeout

以秒為單位的等候上限。

預設值: 3600

--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: 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 來取得完整偵錯記錄。