实例网络带宽调整
更新时间 2025-10-17 14:30:22
最近更新时间: 2025-10-17 14:30:22
接口功能介绍
实例网络带宽调整
接口约束
无
URI
POST /v1/spuInst/adjustBandwidth
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| id | 否 | String | 订单Id，该参数可指定订单Id，不传则使用云平台生成的订单号 | 1a4914183af445669d0b7bff28ef9a43 | |
| sellingPrice | 否 | Integer | 最终售价，所填价格不能低于原价的5.5折。如果是省内出账，该参数必须填，如果是云公司出账，该参数为非必填，不填的情况下就是按默认折扣批价 ，填了则以最终销售价格为准，取值不能低于原价的5.5折 没填如该客户有默认优惠返回金额则以默认优惠为准 没填也没设置默认优惠则以原价为准 | ||
| isPlatformSpecificResource | 否 | Boolean | 是否特定平台，取值范围：true 或false 为true表示是特定平台资源，省公司通过API开通的资源以及资源后续的续订、升级订单只能在省公司crm操作，不能在ctyun系统或者省门户系统 进行订单操作（如升级、续订、退订等等功能）。传false 表示省公司通过API开通的资源后续可以在其他平台进行订单操作，如（升级、续订、退订）不传该属性时，默认为false 不是特定平台） | true | |
| 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 | |
| order | 是 | Object | 订单信息 | order | |
| 表 order |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| item | 是 | String | 订单项 | item | |
| instanceCnt | 是 | String | 订购数量，取值范围：值需大于零且订购数量不能超过50台 | true | |
| cycleCnt | 是 | String | 订购周期，取值范围：值需大于零，不超过384个月 | true | |
| cycleType | 是 | String | 订购周期类型，取值范围：3表示按月订购，5表示按一年订购，6表示按两年订购、7表示按三年订购，cycleCnt属性为1，cycleType取值为3 表示订购1个月 | true | |
| 表 item |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| itemConfig | 是 | Object | 订单项配置信息 | itemConfig | |
| master | 是 | String | 是否为主资源，取值范围：true或false，为true则为主资源，每个订单里每个成套资源只能有一个主资源 | ||
| itemValue | 是 | Integer | 订单值 | 1 | |
| resourceId | 是 | String | 虚拟资源Id | b8d6625d63e045e790af8ccfa573d955 | |
| serviceTag | 是 | String | 只能是OVMS或VMS | OVMS | |
| 表 itemConfig |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| newBandwidthValue | 否 | String | 带宽大小，与value保持一致 | 100 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| message | String | 响应信息 | success | |
| statusCode | Integer | 响应状态码 | 800 | |
| returnObj | Object | 返回对象 |
枚举参数
无
请求示例
请求url
无
请求头header
{}
请求体body
{
"sellingPrice":100,
"isPlatformSpecificResource":true,
"billingOwner":2,
"isPackage":false,
"chargeOffType":"2",
"paymentPlanInitialMonth":"1514538047000",
"autoPay":true,
"order":{
"item":{
"itemConfig":{
"newBandwidthValue":200
},
"master":"true",
"itemValue":"12",
"resourceId":"8033c08180e840c29c84609238bf2f49",
"serviceTag": "OVMS"
},
"instanceCnt":1,
"cycleCnt":1,
"cycleType":1
}
}
响应示例
{
"statusCode": 800,
"message": null,
"returnObj": {
"errorMessage": "",
"submitted": "true",
"newOrderId": "21fee54be0994b6fa78aed86babc62b4",
"newOrderNo": "20220908210048973913",
"totalPrice": 100
}
}
状态码
请参考 状态码
错误码
请参考 错误码
