续费实例费用查询
更新时间 2025-10-17 14:30:21
最近更新时间: 2025-10-17 14:30:21
接口功能介绍
实例费用接口-续费实例-费用查询
接口约束
无
URI
POST /v1/spuInst/describePrice/renewInst
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| packageType | 否 | Integer | 套餐类型，取值范围： 2 包年型套餐活动 1 校园优惠活动 -1 没有套餐活动 | 2 | |
| id | 否 | String | 订单Id，该参数可指定订单Id，不传则使用云平台生成的订单号 | 1a4914183af445669d0b7bff28ef9a43 | |
| sellingPrice | 否 | Integer | 最终售价，所填价格不能低于原价的5.5折。如果是省内出账，该参数必须填，如果是云公司出账，该参数为非必填，不填的情况下就是按默认折扣批价 ，填了则以最终销售价格为准，取值不能低于原价的5.5折 没填如该客户有默认优惠返回金额则以默认优惠为准 没填也没设置默认优惠则以原价为准 | 1 | |
| isPlatformSpecificResource | 否 | Boolean | 是否特定平台，取值范围：true 或false 为true表示是特定平台资源，省公司通过API开通的资源以及资源后续的续订、升级订单只能在省公司crm操作，不能在ctyun系统或者省门户系统 进行订单操作（如升级、续订、退订等等功能）。传false 表示省公司通过API开通的资源后续可以在其他平台进行订单操作，如（升级、续订、退订）不传该属性时，默认为false 不是特定平台） | false | |
| billingOwner | 否 | Integer | 出账方 取值范围 1 和 2 为1表示云公司出账 为2表示省公司出账 默认为1 （云公司出账）续订、升级、退订都是直接继承新购时传的出账方字段值 | 1 | |
| isPackage | 否 | Boolean | 是否融合套餐 取值范围 true 或 false 为true 表示是融合套餐 为false表示不是融合套餐 默认为false（现不管是否省内套餐，最终售价（sellingPrice 参数）都不能低于5.5折；） | true | |
| chargeOffType | 否 | Integer | 出账类型 取值范围 ：1 一次性出账 2 按月 （普通订单只能选择一次性或按月，默认按月出账 ，包年的订单一定是一次性，根据计费反馈，包年订单一次性有优惠） | 1 | |
| paymentPlanInitialMonth | 否 | String | 出账月份 可以自行指定出账月份，如当前月为4月，可以指定为当前月出账或5月（次月）进行出账，传值必须为时间戳（如20180409的时间戳为1523265578713） | 1523265578713 | |
| autoPay | 否 | Boolean | 是否自动支付 取值范围：true 或 false true是自动支付（不需要再单独调用户订单确认接口） false 不是自动支付（需要单独调用用户订单确认接口） 不传默认为false | false | |
| cycleCount | 是 | Integer | 续订周期数量 2表示续订2个月（值需大于零，不超过384个月） | 2 | |
| cycleType | 是 | String | 版本类型 (可选值：单机版（Single）、双副本（Dual）、集群单副本（ClusterSingle） 集群双副本（cluster）) | ClusterSingle | |
| resourceIds | 是 | Array of Strings | 主虚拟资源ID（批量续订时资源不能超过10个） 通过查询资源详细信息接口获取masterResourceId字段 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| message | String | 响应信息 | success | |
| statusCode | Integer | 响应状态码 | 800 | |
| returnObj | Object | 返回对象 | ||
| isSucceed | Boolean | 是否成功 | true | |
| totalPrice | String | 总价 | 3200.0 | |
| finalPrice | String | 最终价格 | 3200.0 | |
| verifyStatusCode | String | 状态码 | 800 | |
| subOrderPrices | Object | 返回对象 | ||
| serviceTag | String | 服务标签 | PASS | |
| orderItemPrices | Object | 订单项价格 | ||
| itemId | String | 订单项ID | 646955254ed949dcb48932fd9641c1e6 | |
| resourceType | String | 资源类型 | DCS |
枚举参数
无
请求示例
请求url
无
请求头header
{}
请求体body
{
"packageType": 2,
"id": "1a4914183af445669d0b7bff28ef9a43",
"sellingPrice": 100,
"isPlatformSpecificResource": true,
"billingOwner": 2,
"isPackage": false,
"chargeOffType": "2",
"paymentPlanInitialMonth": "1514538047000",
"autoPay": true,
"cycleCount": 2,
"cycleType": 3,
"resourceIds": [
"b8d6625d63e045e790af8ccfa573d955"
]
}
响应示例
{
"statusCode": 800,
"message": null,
"returnObj": [{
"isSucceed": true,
"totalPrice": "3000.0",
"finalPrice": "3000.0",
"subOrderPrices": [{
"totalPrice": "3000.0",
"finalPrice": "3000.0",
"serviceTag": "PAAS",
"orderItemPrices": [{
"itemId": "eba2938f104045ff9d806a8ad2c32b60",
"resourceType": "DCS",
"totalPrice": "3000.0",
"finalPrice": "3000.0"
}
]
}
],
"verifyStatusCode": null
}
]
}
状态码
请参考 状态码
错误码
请参考 错误码
