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

适用于 Azure 预留自动化的 API

  • 项目

使用 Azure API 以编程方式为组织获取有关 Azure 服务或软件预留的信息。

查找要购买的预留计划

使用预留建议 API 获取根据组织的使用情况购买预留计划的建议。 有关详细信息，请参阅预留建议。

也可通过“消耗 API 使用情况详细信息”分析资源使用情况。 有关详细信息，请参阅使用情况详细信息 - 按计费帐户划分的计费期间的列表。 始终使用的 Azure 资源通常是最适合预留的。

购买预留项

可以使用 REST API 以编程方式购买 Azure 预留和软件计划。 若要了解详细信息，请参阅预留订单 - 购买 API。

以下是使用 REST API 进行购买的示例请求：

PUT https://management.azure.com/providers/Microsoft.Capacity/reservationOrders/<GUID>?api-version=2019-04-01

请求正文：

{
 "sku": {
    "name": "standard_D1"
  },
 "location": "westus",
 "properties": {
    "reservedResourceType": "VirtualMachines",
    "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
    "term": "P1Y",
    "quantity": "1",
    "displayName": "TestReservationOrder",
    "appliedScopes": null,
    "appliedScopeType": "Shared",
    "reservedResourceProperties": {
      "instanceFlexibility": "On"
    }
  }
}

也可在 Azure 门户中购买预留。 有关详细信息，请参阅以下文章：

服务计划：

软件计划：

获取预留

如果你是签署了企业协议的 Azure 客户（EA 客户），则可获取组织购买的预留，只需使用预留事务 - 列表即可。 对于其他订阅，请获取购买的预留的列表并获取查看权限，方法是使用 API 预留订单 - 列表。 默认情况下，购买了预订的帐户所有者或人员有权查看预留。

查看预留使用情况

如果你是 EA 客户，则可以编程方式查看组织中的预留是如何使用的。 有关详细信息，请参阅预留事务 - 列表。 对于其他订阅，请使用 API 预览摘要 - 按预留订单和预留列出。

如果发现组织的预留未充分使用，请执行以下操作：

授予对预留的访问权限

获取用户可以访问的所有预留的列表，方法是使用预留 - 操作 - 列表 API。 若要以编程方式授予对预留的访问权限，请参阅以下文章之一：

拆分或合并预留

购买一个预留中的多个资源实例后，可能会希望将一个预留中的实例分配给其他订阅。 可以更改预留范围，使之适用于同一计费上下文中的所有订阅。 但出于成本管理或预算目的，可能需要将范围保留为“单个订阅”，将预留实例分配给特定的订阅。

若要拆分某个预留，请使用 API 预留 - 拆分。 也可使用 PowerShell 来拆分预留。 有关详细信息，请参阅管理预留 - 将一个预留拆分成两个预留。

若要将两个预留合并成一个预留，请使用 API 预留 - 合并。

更改预留范围

预留范围可以是计费上下文中的单个订阅、单个资源组或所有订阅。 如果将范围设置为单个订阅或单个资源组，预留将与所选订阅中正在运行的资源进行匹配。 如果删除或移动订阅或资源组，则不会使用预留。 如果将范围设置为共享，Azure 会将预留与计费上下文内所有订阅中运行的资源匹配。 计费上下文依赖于用于购买预留的订阅。 可以在购买时选择范围，也可以在购买后随时更改范围。 有关详细信息，请参阅管理预留 - 更改范围。

若要以编程方式更改范围，请使用 API 预留 - 更新。

了解详细信息