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

az capacity reservation group

命令组“容量预留”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

管理容量预留组。

命令

名称	说明	类型	状态
az capacity reservation group create	创建容量预留组。	核心	预览
az capacity reservation group delete	删除操作以删除容量预留组。 仅当所有关联的资源与预留组取消关联并且预留组下的所有容量预留也已删除时，才允许此操作。 有关更多详细信息，请参阅 https://aka.ms/CapacityReservation。	核心	预览
az capacity reservation group list	列出容量预留组。	核心	预览
az capacity reservation group show	显示容量预留组。	核心	预览
az capacity reservation group update	更新容量预留组。	核心	预览

az capacity reservation group create

预览

命令组“容量预留”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

创建容量预留组。

az capacity reservation group create --capacity-reservation-group
                                     --resource-group
                                     [--location]
                                     [--sharing-profile]
                                     [--tags]
                                     [--zones]

示例

创建容量预留组。

az capacity reservation group create -n ReservationGroupName -g MyResourceGroup

创建具有特定区域的容量预留组。

az capacity reservation group create -n ReservationGroupName -l centraluseuap \
    -g MyResourceGroup --tags key=val --zones 1 2

必需参数

--capacity-reservation-group -n

容量预留组的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--sharing-profile

空间分隔的订阅资源 ID 或无任何 ID。 指定用于为容量预留组资源启用跨订阅共享的设置。 将其指定为不共享。

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--zones -z

可用性区域用于此容量预留组。 如果未提供，则组仅支持该区域中的区域资源。 如果提供，则强制实施组中每个容量预留，以位于其中一个区域。

全局参数

--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 capacity reservation group delete

预览

命令组“容量预留”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

删除操作以删除容量预留组。 仅当所有关联的资源与预留组取消关联并且预留组下的所有容量预留也已删除时，才允许此操作。 有关更多详细信息，请参阅 https://aka.ms/CapacityReservation。

az capacity reservation group delete [--capacity-reservation-group]
                                     [--ids]
                                     [--resource-group]
                                     [--subscription]
                                     [--yes]

示例

删除容量预留组。

az capacity reservation group delete -n ReservationGroupName -g MyResourceGroup --yes

可选参数

--capacity-reservation-group --capacity-reservation-group-name -n

容量预留组的名称。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

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

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

--verbose

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

az capacity reservation group list

预览

命令组“容量预留”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

列出容量预留组。

az capacity reservation group list [--max-items]
                                   [--next-token]
                                   [--resource-group]
                                   [--resource-ids-only {All, CreatedInSubscription, SharedWithSubscription}]
                                   [--vm-instance {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--vmss-instance {0, 1, f, false, n, no, t, true, y, yes}]

示例

列出容量预留组

az capacity reservation group list -g rg

列出包含与容量预留组关联的 VM 实例和 VMSS 实例的容量预留组

az capacity reservation group list -g rg --vm-instance --vmss-instance

可选参数

--max-items

命令输出中要返回的项总数。 如果可用的项总数大于指定的值，则会在命令的输出中提供令牌。 若要恢复分页，请在后续命令的参数中 --next-token 提供令牌值。

--next-token

用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--resource-ids-only

用于提取容量预留组资源 ID 的查询选项。 “CreatedInSubscription”支持提取订阅中创建的所有容量预留组资源的资源 ID。 “SharedWithSubscription”允许提取与订阅共享的所有容量预留组资源的资源 ID。 “All”支持提取与订阅共享并在订阅中创建的所有容量预留组资源的资源 ID。

接受的值: All, CreatedInSubscription, SharedWithSubscription

--vm-instance

检索与响应中的容量预留组关联的虚拟机实例。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--vmss-instance

检索与响应中的容量预留组关联的 ScaleSet VM 实例。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

全局参数

--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 capacity reservation group show

预览

命令组“容量预留”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

显示容量预留组。

az capacity reservation group show --capacity-reservation-group
                                   --resource-group
                                   [--instance-view]

示例

获取容量预留组。

az capacity reservation group show -n ReservationGroupName -g MyResourceGroup

获取容量预留组，其中包含容量预留组下容量预留的实例视图

az capacity reservation group show -n ReservationGroupName -g MyResourceGroup --instance-view

必需参数

--capacity-reservation-group -n

容量预留组的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--instance-view -i

检索容量预留组下容量预留的实例视图列表，该组是由平台管理的容量预留的运行时属性的快照，并且可以在控制平面操作之外更改。

全局参数

--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 capacity reservation group update

预览

命令组“容量预留”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

更新容量预留组。

az capacity reservation group update --capacity-reservation-group
                                     --resource-group
                                     [--sharing-profile]
                                     [--tags]

示例

更新容量预留组。

az capacity reservation group update -n ReservationGroupName -g MyResourceGroup --tags key=val

必需参数

--capacity-reservation-group -n

容量预留组的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--sharing-profile

空间分隔的订阅资源 ID 或无任何 ID。 指定用于为容量预留组资源启用跨订阅共享的设置。 将其指定为不共享。

--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 获取完整的调试日志。