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

az reservations reservation-order

预览
参考

注意

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

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

预留订单。

命令

名称	说明	类型	状态
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-order calculate

预览

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

计算放置价格 ReservationOrder。

az reservations reservation-order calculate [--applied-scope]
                                            [--applied-scope-property]
                                            [--applied-scope-type {ManagementGroup, Shared, Single}]
                                            [--billing-plan {Monthly, Upfront}]
                                            [--billing-scope]
                                            [--display-name]
                                            [--instance-flexibility {Off, On}]
                                            [--location]
                                            [--quantity]
                                            [--renew {0, 1, f, false, n, no, t, true, y, yes}]
                                            [--reserved-resource-type {AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines}]
                                            [--review-date-time]
                                            [--sku]
                                            [--term {P1Y, P3Y, P5Y}]

示例

计算价格

az reservations reservation-order calculate --applied-scope-type Shared --billing-scope 50000000-aaaa-bbbb-cccc-100000000002 --display-name name1 --quantity 1 --reserved-resource-type VirtualMachines --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus

可选参数

--applied-scope

将应用权益的订阅。如果 --applied-scope-type 为 Single，则为必需。请勿指定 --applied-scope-type 是否为“共享”。支持速记语法、json-file 和 yaml-file。请尝试“？？” 以显示更多内容。

--applied-scope-property

特定于应用的范围类型的属性。如果不适用，则不需要。如果 AppliedScopeType 是 ManagementGroup 支持速记语法、json-file 和 yaml-file，则需要提供 tenantId 和 managementGroupId。请尝试“？？” 以显示更多内容。

--applied-scope-type

应用的作用域的类型。

接受的值: ManagementGroup, Shared, Single

--billing-plan

表示计费计划。

接受的值: Monthly, Upfront

--billing-scope

购买预留费用的订阅。

--display-name

预留的友好名称。

--instance-flexibility

打开此项会将预留折扣应用到同一 VM 大小组中的其他 VM。仅指定 VirtualMachines 保留资源类型。

接受的值: Off, On

--location

保留资源的 Azure 区域。

--quantity

属于预留的 SKU 数量。

--renew

如果设置为 true，则会在到期日期时间自动购买新预留。

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

默认值: False

--reserved-resource-type

正在保留的资源的类型。

接受的值: AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines

--review-date-time

这是需要查看 Azure 混合权益的日期时间。

--sku

用于购买的 SKU 名称。

--term

表示预留期限。

接受的值: P1Y, P3Y, P5Y

全局参数

--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 reservation-order calculate-refund

预览

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

如果没有策略错误，则计算返回 Reservations 价格。

az reservations reservation-order calculate-refund --reservation-order-id
                                                   [--id]
                                                   [--quantity]
                                                   [--reservation-id]
                                                   [--scope]

示例

计算退款

az reservations reservation-order calculate-refund --reservation-order-id 0000000-aaaa-bbbb-cccc-20000000001 --id /providers/microsoft.capacity/reservationOrders/0000000-aaaa-bbbb-cccc-20000000001 --scope Reservation --quantity 1 --reservation-id /providers/microsoft.capacity/reservationOrders/0000000-aaaa-bbbb-cccc-20000000001/reservations/50000000-aaaa-bbbb-cccc-200000000000

必需参数

--reservation-order-id

预留的订单 ID。

可选参数

--id

要返回的预留订单的完全限定标识符。

--quantity

要返回的数量。必须大于零。

--reservation-id

要返回的预留的完全限定标识符。

--scope

退款的范围，例如预留。

全局参数

--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 reservation-order change-directory

预览

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

将目录（租户）及其 ReservationOrder 下的所有 Reservation 目录更改为指定的租户 ID。

az reservations reservation-order change-directory --reservation-order-id
                                                   [--destination-tenant-id]

示例

将预留订单更改为另一个租户

az reservations reservation-order change-directory --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000000 --destination-tenant-id 10000000-aaaa-bbbb-cccc-200000000011

必需参数

--reservation-order-id

预留的订单 ID。

可选参数

--destination-tenant-id

要转移到预留订单的租户 ID GUID。

全局参数

--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 reservation-order list

预览

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

用户有权访问当前租户的所有 ReservationOrder列表。

az reservations reservation-order list [--max-items]
                                       [--next-token]

示例

用户有权访问当前租户的所有预留订单的列表。

az reservations reservation-order list

可选参数

--max-items

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

--next-token

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

全局参数

--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 reservation-order purchase

预览

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

在指定的 URI 下创建 ReservationOrder 和创建资源。

az reservations reservation-order purchase --reservation-order-id
                                           [--applied-scope]
                                           [--applied-scope-property]
                                           [--applied-scope-type {ManagementGroup, Shared, Single}]
                                           [--billing-plan {Monthly, Upfront}]
                                           [--billing-scope]
                                           [--display-name]
                                           [--instance-flexibility {Off, On}]
                                           [--location]
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--quantity]
                                           [--renew {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--reserved-resource-type {AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines}]
                                           [--review-date-time]
                                           [--sku]
                                           [--term {P1Y, P3Y, P5Y}]

示例

购买单个范围预留

az reservations reservation-order purchase --reservation-order-id 40000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type Single --billing-scope 50000000-aaaa-bbbb-cccc-200000000005 --reserved-resource-type VirtualMachines --display-name name1 --quantity 1 --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus --applied-scope 50000000-aaaa-bbbb-cccc-200000000010

使用资源组预留购买单个范围

az reservations reservation-order purchase --reservation-order-id 40000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type Single --billing-scope 50000000-aaaa-bbbb-cccc-200000000005 --reserved-resource-type VirtualMachines --display-name testername1 --quantity 1 --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus --applied-scope '/subscriptions/50000000-aaaa-bbbb-cccc-200000000005/resourceGroups/rg1' --instance-flexibility Off

必需参数

--reservation-order-id

预留的订单 ID。

可选参数

--applied-scope

--applied-scope-property

--applied-scope-type

应用的作用域的类型。

接受的值: ManagementGroup, Shared, Single

--billing-plan

表示计费计划。

接受的值: Monthly, Upfront

--billing-scope

购买预留费用的订阅。

--display-name

预留的友好名称。

--instance-flexibility

打开此项会将预留折扣应用到同一 VM 大小组中的其他 VM。仅指定 VirtualMachines 保留资源类型。

接受的值: Off, On

--location

保留资源的 Azure 区域。

--no-wait

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

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

--quantity

属于预留的 SKU 数量。

--renew

如果设置为 true，则会在到期日期时间自动购买新预留。

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

默认值: False

--reserved-resource-type

正在保留的资源的类型。

--review-date-time

这是需要查看 Azure 混合权益的日期时间。

--sku

用于购买的 SKU 名称。

--term

表示预留期限。

接受的值: P1Y, P3Y, P5Y

全局参数

--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 reservation-order return

预览

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

返回预留。

az reservations reservation-order return --reservation-order-id
                                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--quantity]
                                         [--reservation-id]
                                         [--return-reason]
                                         [--scope]
                                         [--session-id]

示例

返回预留

az reservations reservation-order return --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000000 --return-reason mockReason --scope Reservation --quantity 1 --reservation-id /providers/microsoft.capacity/reservationOrders/50000000-aaaa-bbbb-cccc-200000000000/reservations/30000000-aaaa-bbbb-cccc-200000000011 --session-id 40000000-aaaa-bbbb-cccc-200000000020

必需参数

--reservation-order-id

预留的订单 ID。

可选参数

--no-wait

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

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

--quantity

要返回的数量。必须大于零。

--reservation-id

要返回的预留的完全限定标识符。

--return-reason

返回预留的原因。

--scope

退款的范围，例如预留。

--session-id

CalculateRefund 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 reservation-order show

预览

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

获取 . 的详细信息 ReservationOrder。

az reservations reservation-order show --reservation-order-id
                                       [--expand]

示例

获取预留订单的详细信息

az reservations reservation-order show --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000005

必需参数

--reservation-order-id

预留的订单 ID。

可选参数

--expand

可用于扩展 planInformation。

全局参数

--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 reservation-order wait

预览

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

将 CLI 置于等待状态，直到满足条件。

az reservations reservation-order wait --reservation-order-id
                                       [--created]
                                       [--custom]
                                       [--deleted]
                                       [--exists]
                                       [--expand]
                                       [--interval]
                                       [--timeout]
                                       [--updated]

必需参数

--reservation-order-id

预留的订单 ID。

可选参数

--created

等待在“Succeeded”中使用“provisioningState”创建。

默认值: False

--custom

等待条件满足自定义 JMESPath 查询。例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到删除为止。

默认值: False

--exists

等待资源存在。

默认值: False

--expand

可用于扩展 planInformation。

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

Share via

az reservations reservation-order

命令

az reservations reservation-order calculate

示例

可选参数

az reservations reservation-order calculate-refund

示例

必需参数

可选参数

az reservations reservation-order change-directory

示例

必需参数

可选参数

az reservations reservation-order list

示例

可选参数

az reservations reservation-order purchase

示例

必需参数

可选参数

az reservations reservation-order return

示例

必需参数

可选参数

az reservations reservation-order show

示例

必需参数

可选参数

az reservations reservation-order wait

必需参数

可选参数

反馈

其他资源