有奖捉虫:云通信与企业服务文档专题,速来> HOT

1. 接口描述

本接口(InquiryMongoDB)用于获取副本集实例价格(包年包月),支持新购、续费、升级实例时价格查询。
接口请求域名:mongodb.api.qcloud.com

2. 输入参数

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

不同的产品输入参数也不一样。具体是:

2.1 新购实例时查询价格

参数名称 是否必选 类型 描述
operation String 必须填newmongodb,表示新购实例
zoneId Int 可用区ID,请使用查询可创建实例规格接口获取可创建的可用区
typeId String 实例类型英文名称。 GIO:高IO版;TGIO:高IO万兆
memory Int 实例内存大小,每一个内存值对应一个可选的磁盘大小范围,单位:MB
diskSize Int 实例磁盘大小,单位:GB
secondaryNum Int 副本集实例从节点个数,暂时只支持从节点个数为2
version Int 数据库版本号,暂时只支持 MONGO_3_WT
goodsNum Int 一次购买的实例数
period Int 购买时长, 单位:月, 取值范围 [1,2,3,4,5,6,7,8,9,10,11,12,24,36]

2.2 续费实例时查询价格

参数名称 是否必选 类型 描述
operation String 必须填renewmongodb,表示续费实例
instanceId String 待操作的实例ID,可通过 DescribeMongoDBInstances 接口返回值中的 instanceId 获取。
period Int 续费时长,单位:月, 取值范围 [1,2,3,4,5,6,7,8,9,10,11,12,24,36]

2.3 升级实例时查询价格

参数名称 是否必选 类型 描述
operation String 必须填upgrademongodb,表示升级实例
instanceId String 待操作的实例ID,可通过 DescribeMongoDBInstances 接口返回值中的 instanceId 获取。
memory Int 升级后的实例内存大小,每一个内存值对应一个可选的磁盘大小范围,单位:MB
diskSize Int 升级后的实例磁盘大小,单位:GB

3. 输出参数

参数名称 类型 描述
code Int 公共错误码, 0表示成功,其他值表示失败。详见错误码页面的公共错误码
message String 错误信息描述, 成功时,该值为空
codeDesc String 业务侧错误码英文描述。成功时返回Success,错误时返回具体业务错误原因。
data Object 实例价格内容

其中,data 表示实例价格内容,其参数构成如下:

参数名称 类型 描述
data.price Int 实例的价格,单位:分(人民币)

4. 错误码

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

错误代码 英文提示 错误描述
11050 InvalidParameter 业务参数错误
11060 ServiceUnavailable 请求的区域暂时不提供服务
11071 UserNotInWhiteList 用户不在白名单中
11061 TypeIdIllegal 无效的typeId
11062 MemSizeExceedMaxLimit 请求的内存容量超过最大上限
11063 MemSizeIllegal 请求的内存内存不是1024的整数倍
11064 MemSizeNotInRange 请求的内存容量不在售卖范围内
11065 RequestSizeIllegal 请求的内存或磁盘容量非法,内存容量必须是1024整数倍,磁盘容量必须是整数
11066 DiskSizeNotInRange 请求的磁盘不在售卖范围内
11067 PeriodNotInRange 请求的时长不在售卖范围内,时长取值范围 [1,2,3,4,5,6,7,8,9,10,11,12,24,36],单位:月
11072 SecondaryNumNotInRange 副本集实例,从节点个数不在售卖范围内,从节点数取值范围[1,2]
11056 InstanceNotExists 没有找到对应实例
11051 InstanceDeleted 实例到期已被回收
11068 UpgradeNotAllowedOnZoneId 该区域不支持升级实例
11069 DiskSizeLessThanRealSize 请求的磁盘容量小于实际值
11070 MemSizeLessThanRealSize 请求的内存容量小于实际值

5. 示例

输入

https://mongodb.api.qcloud.com/v2/index.php?Action=InquiryMongoDB
&<公共请求参数>
&operation=newmongodb
&zoneId=100002
&typeId=GIO
&memory=8192
&diskSize=245
&secondaryNum=2
&version=MONGO_3_MMAP
&goodsNum=1
&period=1

输出

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "price": 188800
    }
}