下单续订单(N100型)
更新时间 2026-04-17 15:57:01
最近更新时间: 2026-04-17 15:57:01
接口功能介绍
云防火墙（原生版）-N100型产品的包年/包月的续订功能
接口约束
无
URI
POST /v1/cngfw/order/place_renew
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| cycleCnt | 是 | Integer | 续订周期数，取值范围：值需大于0，不超过60个月 | 1 | |
| cycleType | 是 | Integer | 订购周期类型，取值范围：[3,5,6,7,8,9] 3表示按月订购，5：按年订购，6：按两年订购，7：按三年订购，8：按四年订购，9：按5年订购； 当取值为7，8，9时，cycleCnt固定传值：1 | 3 | |
| resourceIds | 是 | String of Array(String) | 资源id数组，包含云防火墙（原生版）资源id、云主机资源id |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 状态码，800：成功，900：失败 | ||
| message | String | 返回信息 | 成功 | |
| error | String | 错误信息 | ||
| returnObj | Object | 接口返回结果 | returnObj | |
| errorCode | String | 错误码 |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| errorMessage | String | 下单失败 | ||
| submitted | Boolean | 是否已提交成功，true：成功，false：失败 | true | |
| orderPlacedEvents | Array of Objects | 订单项明细 | orderPlacedEvents |
表 orderPlacedEvents
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| errorMessage | String | 下单失败 | ||
| submitted | Boolean | 是否已提交成功，true：成功，false：失败 | true | |
| newOrderId | String | 主订单id | ||
| newOrderNo | String | 主订单NO | ||
| totalPrice | Double | 订单价格 |
枚举参数
参数名 statusCode
| 枚举值 | 类型 | 说明 |
|---|---|---|
| 800 | Integer | 成功 |
| 900 | Integer | 失败 |
请求示例
请求url
https://ctcfw-global.ctapi.ctyun.cn/v1/cngfw/order/place_renew
请求头header
无
请求体body
{
"cycleCount": 1,
"cycleType": 3,
"resourceIds": ["xxxxxxxx","xxxxxxxx"]
}
响应示例
{
"statusCode": 800,
"returnObj": {
"errorMessage": "",
"submitted": true,
"orderPlacedEvents": [
{
"errorMessage": "",
"submitted": true,
"newOrderId": "xxxxxxxxxx",
"newOrderNo": "2026xxxxxxxxxxx",
"totalPrice": 3030.0
}
]
},
"akInfo": ""
}
状态码
请参考 状态码
错误码
请参考 错误码
