查询价格(按量计费)

最近更新时间:2018-04-27 16:49:56

1. 接口描述

本接口(InquiryCdbPriceHour)用于查询云数据库实例某一个类型的按量计费价格(单位:元/小时),可传入实例类型、购买数量、内存大小、硬盘大小和可用区ID来查询实例价格。
您还可以使用创建实例(按量计费)接口来创建一个新实例。
接口请求域名:cdb.api.qcloud.com

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。其中,此接口的Action字段为InquiryCdbPriceHour。

参数名称 是否必选 类型 描述
cdbType String 实例规格,支持固定规格和自定义规格;传 CUSTOM 代表自定义规格, 固定规格的取值,请使用查询可创建规格接口获取。 固定规格类型将会下线,推荐使用自定义规格。
goodsNum Int 实例数量,默认值为1, 最小值1,最大值为10,请使用查询可创建规格(支持可用区、配置自定义)接口获取可创建的实例数量
memory Int 实例内存大小,单位:MB,当 cdbType 值为 CUSTOM 时, memory 为必填;当 cdbType 为整型值时,传入 memory 值将无效,请使用查询可创建规格(支持可用区、配置自定义)接口获取可创建的内存规格
volume Int 实例硬盘大小,单位:GB,当 cdbType 值为 CUSTOM 时, volume 为必填;当 cdbType 为整型值时,传入 volume 值将无效,请使用查询可创建规格(支持可用区、配置自定义)接口获取可创建的硬盘范围
zoneId Int 可用区ID,该参数缺省时,系统会自动选择一个可用区,请使用查询可创建规格(支持可用区、配置自定义)接口获取可创建的可用区
instanceRole String 实例类型,默认为 master,支持值包括:master-表示主实例,dr-表示灾备实例,ro-表示只读实例
protectMode Int 数据复制方式,默认为0,支持值包括:0-表示异步复制,1-表示半同步复制,2-表示强同步复制,查询主实例时可指定该参数,查询只读实例或者灾备实例时指定该参数无意义

3. 输出参数

参数名称 类型 描述
code Int 公共错误码, 0表示成功,其他值表示失败。详见错误码页面的公共错误码
message String 模块错误信息描述,与接口相关。
codeDesc String 英文错误描述
price Int 实例价格,单位:分(人民币)
originalPrice Int 实例原价,单位:分(人民币)

4. 错误码表

以下错误码表列出了该接口的业务逻辑错误码。

错误代码 英文提示 错误描述
9003 InvalidParameter 参数错误
9006 InternalError 数据库内部错误
9301 InvalidParameter 交易参数错误

5. 示例

输入

https://cdb.api.qcloud.com/v2/index.php?Action=InquiryCdbPrice
&<公共请求参数>
&cdbType=CUSTOM
&memory=1000
&volume=25
&goodsNum=1
&zoneId=100003

输出

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "price": 35,
    "originalPrice": 35
}