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

az reservations

注意

此参考是 Azure CLI（版本 2.50.0 或更高版本）的预留扩展的一部分。 该扩展将在首次运行 az reservations 命令时自动安装。 详细了解扩展。

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

Azure 预留。

命令

名称	说明	类型	Status
az reservations calculate-exchange	计算在没有策略错误的情况下交换 Reservations 的价格。	分机	预览版
az reservations catalog	预留目录。	扩展	预览版
az reservations catalog show	获取可用预留目录。	扩展	预览
az reservations exchange	返回一个或多个 Reservations 以换取一个或多个 Reservation 购买。	扩展	预览
az reservations list	列出用户有权在当前租户中访问的预留。	分机	预览
az reservations reservation	预留。	分机	预览
az reservations reservation-order	预留订单。	分机	预览
az reservations reservation-order-id	预留订单 ID。	分机	预览
az reservations reservation-order-id list	列出适用于 Reservation此订阅或此订阅下的资源组。	分机	预览
az reservations reservation-order calculate	计算放置价格 ReservationOrder。	分机	预览
az reservations reservation-order calculate-refund	如果没有策略错误，则计算返回 Reservations 价格。	分机	预览版
az reservations reservation-order change-directory	将目录（租户）及其 ReservationOrder 下的所有 Reservation 目录更改为指定的租户 ID。	分机	预览
az reservations reservation-order list	用户有权访问当前租户的所有 ReservationOrder列表。	扩展	预览版
az reservations reservation-order purchase	在指定的 URI 下创建 ReservationOrder 和创建资源。	分机	预览
az reservations reservation-order return	返回预留。	分机	预览
az reservations reservation-order show	获取 . 的详细信息 ReservationOrder。	分机	预览
az reservations reservation-order wait	将 CLI 置于等待状态，直到满足条件。	分机	预览版
az reservations reservation archive	Reservation存档处于已取消/过期状态的存档，并将其移动到Archived状态。	分机	预览版
az reservations reservation list	列出单个 ReservationOrder中的预留项。	分机	预览
az reservations reservation list-available-scope	列出可用的范围 Reservation。	扩展	预览
az reservations reservation list-history	所有修订 Reservation的列表。	分机	预览
az reservations reservation merge	将指定的 Reservations 合并为新的 Reservation。 要合并的两 Reservation个属性必须相同。	分机	预览
az reservations reservation show	获取特定 Reservation 详细信息。	分机	预览
az reservations reservation split	将一个 Reservation 拆分为具有指定数量分布的两 Reservation个 s。	分机	预览
az reservations reservation unarchive	取消存档 Reservation 将其移动到存档之前的状态。	分机	预览
az reservations reservation update	更新应用的作用域、续订、名称、实例灵活性 Reservation。	分机	预览版
az reservations reservation wait	将 CLI 置于等待状态，直到满足条件。	扩展	预览

az reservations calculate-exchange

预览

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

计算在没有策略错误的情况下交换 Reservations 的价格。

az reservations calculate-exchange [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--ris-to-exchange]
                                   [--ris-to-purchase]
                                   [--sp-to-purchase]

示例

计算交换

az reservations calculate-exchange --ris-to-exchange "[{reservation-id:/providers/microsoft.capacity/reservationOrders/40000000-aaaa-bbbb-cccc-200000000012/reservations/51000000-aaaa-bbbb-cccc-200000000012,quantity:1},{reservation-id:/providers/microsoft.capacity/reservationOrders/90000000-aaaa-bbbb-cccc-200000000012/reservations/36000000-aaaa-bbbb-cccc-200000000012,quantity:1}]" --ris-to-purchase "[{reserved-resource-type:VirtualMachines,applied-scope-type:Shared,billing-scope:12350000-aaaa-bbbb-cccc-200000000012,display-name:exchangeTest1,quantity:1,sku:Standard_B1s,term:P1Y,billing-plan:Monthly,location:eastus},{reserved-resource-type:VirtualMachines,applied-scope-type:Shared,billing-scope:12350000-aaaa-bbbb-cccc-200000000012,display-name:exchangeTest2,quantity:1,sku:Standard_B1s,term:P1Y,billing-plan:Monthly,location:eastus}]"

可选参数

--no-wait

不等待长时间运行的操作完成。

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

--ris-to-exchange

在此交换中返回的预留的列表。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--ris-to-purchase

在此交换中购买的预留列表。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--sp-to-purchase

在此交换中购买的储蓄计划列表。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

全局参数

--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 reservations exchange

预览

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

返回一个或多个 Reservations 以换取一个或多个 Reservation 购买。

az reservations exchange [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                         [--session-id]

示例

Exchange 预留

az reservations exchange --session-id 40000000-aaaa-bbbb-cccc-200000000012

可选参数

--no-wait

不等待长时间运行的操作完成。

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

--session-id

CalculateExchange API 返回的 SessionId。

全局参数

--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 reservations list

预览

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

列出用户有权在当前租户中访问的预留。

az reservations list [--filter]
                     [--max-items]
                     [--next-token]
                     [--orderby]
                     [--selected-state]

示例

列出当前租户下的预留

az reservations list

列出当前租户下的“失败”状态的预留

az reservations list --selected-state "Failed"

列出当前租户下的所有“VirtualMachines”预留

az az reservations list --filter "properties/reservedResourceType eq 'VirtualMachines'"

按数量按降序列出预留和订购结果

az reservations list --orderby 'properties/quantity desc'

可选参数

--filter

可用于按预留属性进行筛选。 筛选器支持“eq”、“or”和“and”。 它目前不支持“ne”、“gt”、“le”、“ge”或“not”。 预留属性包括 sku/name、properties/{appliedScopeType、archived、displayName、displayProvisioningState、effectiveDateTime、expiryDate、provisioningState、quantity、renew、reservedResourceType、term、userFriendlyAppliedScopeType、userFriendlyRenewState}。

--max-items

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

--next-token

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

--orderby

可用于按预留属性对订单进行排序。

--selected-state

所选预配状态。

全局参数

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