开通查价
更新时间 2025-11-21 17:14:50
最近更新时间: 2025-11-21 17:14:50
接口功能介绍
开通查价
接口约束
无
URI
POST /v3/instance/queryPrice
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池编码 | 100054c0416811e9a6690242ac110002 |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| cycleType | 是 | String | 计费模式101:按需 3:按月订购 | ||
| cycleCnt | 否 | String | cycleType=3时，必填；订购周期，取值范围：值需大于零，不超过384个月 | ||
| hostType | 否 | String | 主机类型： C | ||
| engineType | 是 | String | 引擎类型 | ||
| cpuNum | 是 | Integer | 节点cpu核数 | ||
| memSize | 是 | String | 节点内存，单位G | ||
| nodeNum | 是 | Integer | 节点数 | ||
| diskType | 是 | String | 存储类型 SAS 、SSD | ||
| diskSize | 是 | Integer | 节点存储空间大小,单位G |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | String | 接口系统层面状态码。成功：800，失败：900 | 800 | |
| message | String | 描述状态 | ||
| returnObj | Object | 返回对象 | returnObj | |
| error | String | 错误码，只有非成功才有这个字段，方便快速定位问题 | 201 | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| data | Object | 订单核心数据。仅接口调用成功时返回 | data | |
| 表 data |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| totalPrice | String | 总价格 | ||
| finalPrice | String | 最终价格 | ||
| subOrderPrices | Array of Objects | 子订单集合 | subOrderPrice | |
| 表 subOrderPrice |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| totalPrice | String | 总价格 | ||
| serviceTag | String | 服务标签 | ||
| finalPrice | String | 最终价格 | ||
| orderItemPrices | Array of Objects | 订单子项价格 | orderItemPrice | |
| 表 orderItemPrice |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| itemId | String | 项目id | ||
| totalPrice | String | 总价格 | ||
| finalPrice | String | 最终价格 | ||
| resourceType | String | 资源类型 | ||
| PAAS_DMQ-主资源Rocketmq | ||||
| PAAS_DMQ_EBS - 云硬盘 |
枚举参数
无
请求示例
请求url
https://[endpoint].ctapi.ctyun.cn/v3/instance/queryPrice
请求头header
无
请求体body
{
"cycleType": "101",
"diskSize": 100,
"nodeNum": 1,
"hostType": "C",
"engineType": "ctgmq-advance",
"diskType": "SSD",
"cpuNum": 2,
"memSize": "4"
}
响应示例
响应成功案例
{
"message": "success",
"returnObj": {
"data": {
"totalPrice": "1.15",//总价格
"subOrderPrices": [
{
"totalPrice": "1.15",//总价格
"serviceTag": "PAAS",// 服务标签
"finalPrice": "1.15",// 最终价格
"orderItemPrices": [
{
"itemId": "f796ba566ee34d818a60fd02411ba178",// 项目id
"totalPrice": "0.98",//总价格
"finalPrice": "0.98",//最终价格
"resourceType": "PAAS_DMQ"// 资源类型，PAAS_DMQ为rokcetmq实例，PAAS_DMQ_EBS为云硬盘
},
{
"itemId": "c511b35f2ebc4646b94b744386cedbd2",
"totalPrice": "0.17",
"finalPrice": "0.17",
"resourceType": "PAAS_DMQ_EBS"
}
]
}
],//子订单价格项
"finalPrice": "1.15"// 最终价格
}
},
"statusCode": 800
}
响应失败案例
{
"statusCode": 900,
"message": "engineType not valid, valid perms is ctgmq-advance or ctgmq",
"returnObj": null,
"error": "ROCKETMQ_0500"
}
状态码
请参考 状态码
错误码
请参考 错误码
