功能介绍:实例带宽续费
POST https://[endpoint].ctapi.ctyun.cn/v1/spuInst/renewAdditionalBandwidth
Content-Type:application/json
请求体参数说明:
参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
---|---|---|---|---|
packageType | 2 | String | 否 | 套餐类型,取值范围:2包年型套餐活动1 校园优惠活动-1 没有套餐活动 |
id | 1a4914183af445669d0b7bff28ef9a43 | String | 否 | 订单Id,该参数可指定订单Id,不传则使用云平台生成的订单号 |
isPlatformSpecificResource | false | boolean | 否 | 是否特定平台,取值范围:true 或false 为true表示是特定平台资源,省公司通过API开通的资源以及资源后续的续订、升级订单只能在省公司crm操作,不能在ctyun系统或者省门户系统 进行订单操作(如升级、续订、退订等等功能)。传false 表示省公司通过API开通的资源后续可以在其他平台进行订单操作,如(升级、续订、退订)不传该属性时,默认为false 不是特定平台) |
billingOwner | 1 | String | 否 | 出账方 取值范围 1 和 2为1表示云公司出账 为2表示省公司出账 默认为1 (云公司出账)续订、升级、退订都是直接继承新购时传的出账方字段值 |
isPackage | true | boolean | 否 | 是否融合套餐 取值范围 true 或 false 为true 表示是融合套餐 为false表示不是融合套餐 默认为false |
chargeOffType | 1 | String | 否 | 出账类型 取值范围 :1 一次性出账 2 按月 (普通订单只能选择一次性或按月,默认按月出账 ,包年的订单一定是一次性,根据计费反馈,包年订单一次性有优惠) |
autoPay | false | boolean | 否 | 是否自动支付 取值范围:true 或 false true是自动支付(不需要再单独调用户订单确认接口) false 不是自动支付(需要单独调用用户订单确认接口) 不传默认为true |
cycleCount | 2 | String | 是 | 续订周期数量 2表示续订2个月(值需大于零,不超过384个月) |
cycleType | 3 | String | 是 | 3表示按月订购,5表示按一年订购,6表示按两年订购、7表示按三年订购。cycleCnt属性为1,cycleType取值为3 表示订购1个月 |
resourceIds | Array | 是 | 主虚拟资源ID(批量续订时资源不能超过10个)通过查询资源详细信息接口获取masterResourceId字段 |
返回参数说明:
参数名 | 示例值 | 参数类型 | 参数描述 |
---|---|---|---|
message | success | String | 响应信息 |
statusCode | 800 | int | 响应状态码 |
returnObj | Object | 返回对象 | |
errorMessage | String | 错误信息 | |
submitted | true | String | 是否提交成功 |
orderPlacedEvents | Object | ||
newOrderId | 54ea33160b2d47939cc687963edc8da9 | String | 新订单Id |
newOrderNo | 20220907202909646445 | String | 新订单号 |
totalPrice | 100 | int | 总价 |
请求示例:
POST https://[endpoint].ctapi.ctyun.cn/v1/spuInst/renewAdditionalBandwidth
{
"packageType":"2",
"isPlatformSpecificResource":true,
"billingOwner":"2",
"isPackage":false,
"chargeOffType":"2",
"autoPay":true,
"cycleCount":"2",
"cycleType":"3",
"resourceIds":[
"44b278ae052f48c6905a4cd20071985b"
]
}
返回示例:
{
"statusCode": 800,
"message": null,
"returnObj": {
"errorMessage": "",
"submitted": "true",
"orderPlacedEvents": [
{
"errorMessage": "",
"submitted": "true",
"newOrderId": "20220419104546394002 ",
"newOrderNo": "20220907204911413320",
"totalPrice": 100
}
]
}
}