概述
节省计划是一种折扣权益计划，您可以通过承诺在一定期限（1年或3年）内使用稳定数量的资源（以元/小时为单位衡量），来换取较低的按量付费折扣。购买节省计划后，每小时账单中不超过承诺消费的部分将享受节省计划特有的折扣后进行抵扣。相比包年包月实例，及预留实例劵和按量付费实例的组合，节省计划和按量付费实例的组合在使用上更加灵活。
本章节介绍的节省计划 API 接口均为 API 3.0接口。
您可以调用 API 对节省计划进行操作，例如创建节省计划订单、查询节省计划使用率明细等。
节省计划支持的所有接口信息，请参见 API 概览。
术语表
节省计划 API 接口的常见术语请参见下表：
| 术语 | 描述 |
|---|---|
| 节省计划使用率 | 使用率是当前客户购买的全部节省计划包的实际使用比率。反映节省计划额度的利用程度，使用率越高，说明节省计划的使用越充分。计算公式：节省计划使用率 = 节省计划抵扣金额 / 节省计划承诺金额。其中，节省计划抵扣金额代表在一定时间内给按量付费账单抵扣时消耗的节省计划额度；节省计划承诺金额则代表在对应时间内，客户承诺消费的总和。 |
| 节省计划覆盖率 | 覆盖率是当前客户购买的全部节省计划包对于符合抵扣条件的按量计费实例资源的抵扣覆盖比率。反映节省计划对按量付费资源的抵扣比例，覆盖率越高，说明节省计划越有效地帮助降低了成本。计算公式：节省计划覆盖率 = 节省计划抵扣金额 / 节省计划适用资源的总支出金额。其中，节省计划抵扣金额代表在一定时间内给按量付费账单抵扣时实付的节省计划金额；节省计划适用资源的总支出金额则代表节省计划抵扣金额与超出节省计划部分的按量付费金额的总和。 |
使用限制
对于具体的参数限制，请参考各接口文档中的参数说明。
API 快速入门
您可以使用 API Explorer 工具在线调用 API。
本文以购买节省计划以及查看节省计划的使用率和覆盖率为例，通过 API Explorer 工具调用 API 接口的步骤如下：
- 进入 API Explorer 工具页面。更多 API Explorer 工具使用信息，请参见 使用 API Explorer。
- 调用 CreateSavingPlanOrder 接口，选择适用的承诺金额和付费类型，创建节省计划。
- 在节省计划生效后，若存在符合节省计划条件的按量付费资源订单，则会自动使用节省计划额度进行抵扣，享用节省计划折扣。当节省计划额度消耗完成，剩余未被节省计划抵扣的按量付费刊例价，将正常使用按量付费模式的折扣进行扣费结算。
- 调用 DescribeSavingPlanOverview 接口，可以查询到已购买的节省计划明细信息，包含节省计划承诺金额、开始抵扣时间、结束抵扣时间等。
- 在节省计划抵扣的次日，可以调用 DescribeSavingPlanUsage 接口，查询当前用户在指定时间段内的节省计划使用情况；调用 DescribeSavingPlanCoverage 接口，查询当前用户在指定时间段内节省计划覆盖率明细数据。如无特别说明，金额单位均为元（国内站）或者美元（国际站）。
