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

az hpc-cache

参考

注意

此参考是 Azure CLI（版本 2.3.0 或更高版本）的 hpc 缓存扩展的一部分。该扩展将在首次运行 az hpc-cache 命令时自动安装。详细了解扩展。

用于管理 hpc 缓存的命令。

命令

名称	说明	类型	状态
az hpc-cache blob-storage-target	用于创建 hpc 缓存 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	告知缓存将所有脏数据写入存储目标（s）。在刷新期间，客户端将看到返回的错误，直到刷新完成。	分机	GA
az hpc-cache list	返回用户有权访问的资源组下的所有缓存。	扩展	GA
az hpc-cache nfs-storage-target	用于创建 hpc 缓存 nfs 存储目标的命令。	扩展	GA
az hpc-cache nfs-storage-target add	创建或更新 nfs 存储目标。可以随时允许此操作，但如果缓存关闭或运行不正常，则存储目标的实际创建/修改可能会延迟，直到缓存再次正常。	扩展	GA
az hpc-cache nfs-storage-target update	创建或更新 nfs 存储目标。可以随时允许此操作，但如果缓存关闭或运行不正常，则存储目标的实际创建/修改可能会延迟，直到缓存再次正常。	分机	GA
az hpc-cache show	返回缓存。	扩展	GA
az hpc-cache skus	用于管理 hpc 缓存 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 缓存存储目标的命令。	分机	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 缓存使用模型的命令。	分机	GA
az hpc-cache usage-model list	获取此订阅可用的缓存使用情况模型列表。	分机	GA
az hpc-cache wait	等待 hpc 缓存到指定状态。	分机	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

Location。 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

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

az hpc-cache flush

告知缓存将所有脏数据写入存储目标（s）。在刷新期间，客户端将看到返回的错误，直到刷新完成。

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

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

az hpc-cache wait

等待 hpc 缓存到指定状态。

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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

通过

az hpc-cache

命令

az hpc-cache create

示例

必需参数

可选参数

az hpc-cache delete

示例

必需参数

可选参数

az hpc-cache flush

示例

必需参数

az hpc-cache list

示例

可选参数

az hpc-cache show

示例

必需参数

az hpc-cache start

示例

必需参数

可选参数

az hpc-cache stop

示例

必需参数

可选参数

az hpc-cache update

示例

必需参数

可选参数

az hpc-cache upgrade-firmware

示例

必需参数

az hpc-cache wait

示例

必需参数

可选参数

其他资源