通过QuerySavingsPlansDiscount查询节省计划折扣明细-费用与成本-阿里云

查询节省计划折扣信息列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

bssapi:QuerySavingsPlansDiscount

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
ModuleCode	string	否	模块 CODE	instance_type
PayMode	string	是	付费类型: total 全预付 half 半预付 zero 0 预付	total
PageSize	integer	否	每页个数	20
SpnType	string	是	节省计划类型: ecs 计算型 universal 通用型	universal
Locale	string	否	多语言标识	ZH
Cycle	string	是	查询周期	1:Year
PageNum	integer	否	查询页数	1
Spec	string	否	资源类型	ecs.g6
CommodityCode	string	是	商品 CODE	ecs
Region	string	否	地域信息	cn-hangzhou
SpnCommodityCode	string	否	节省计划商品 Code	savingplan_common_public_cn

返回参数

名称	类型	描述	示例值
	object	结果
Message	string	错误信息	This API is not applicable for caller.
RequestId	string	请求 ID	6000EE23-274B-4E07-A697-FF2E999520A4
Data	object	data
HostId	string	请求 IP	100.104.180.109
Items	array<object>	折扣信息列表
	object	折扣明细
CommodityName	string	产品明细	云服务器ECS-按量付费
ModuleName	string	计价模块名称。	实例
SpnType	string	节省计划类型	universal
PayMode	string	付款类型： total 全预付 half 半预付 zero 0 预付	total
Cycle	string	查询周期	1:Year
Region	string	地域信息	张家口
RegionCode	string	实例所在地域 ID，您可以调用 DescribeDBInstanceAttribute 查询。	cn-hangzhou
Spec	string	资源类型	ecs.g6
DiscountRate	string	官网折扣率	0.85
ContractDiscountRate	string	合同折扣率	0.85
Code	string	错误码	PARAM_ERROR
Success	boolean	调用是否成功	true

示例

正常返回示例

JSON格式

{
  "Message": "This API is not applicable for caller.",
  "RequestId": "6000EE23-274B-4E07-A697-FF2E999520A4",
  "Data": {
    "HostId": "100.104.180.109",
    "Items": [
      {
        "CommodityName": "云服务器ECS-按量付费",
        "ModuleName": "实例",
        "SpnType": "universal",
        "PayMode": "total",
        "Cycle": "1:Year",
        "Region": "张家口",
        "RegionCode": "cn-hangzhou",
        "Spec": "ecs.g6",
        "DiscountRate": "0.85",
        "ContractDiscountRate": "0.85"
      }
    ]
  },
  "Code": "PARAM_ERROR",
  "Success": true
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。