下单升配单(N100型)
更新时间 2026-04-17 15:56:52
最近更新时间: 2026-04-17 15:56:52
接口功能介绍
云防火墙（原生版）-N100型产品规格的包年/包月的升配功能
接口约束
无
URI
POST /v1/cngfw/order/place_upgrade
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| resourceId | 是 | String | 云防火墙（原生版）资源id | 1 | |
| ismain | 是 | String | 云防火墙（原生版）部署方式，single：单机部署，dual：主备部署 | single | |
| firewallEdition | 是 | String | 云防火墙公网处理能力（版本），取值范围：standard-100Mbps，advanced-200Mbps，ultimated-2Gbps | advanced |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| errorMessage | String | 下单失败描述，具体订单失败取该错误消息描述 | ||
| submitted | Boolean | 是否已提交成功，true：成功，false：失败 | true | |
| newOrderId | String | 主订单id | ||
| newOrderNo | String | 主订单NO | ||
| totalPrice | Double | 订单价格 |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| errorMessage | String | 下单失败 | ||
| submitted | Boolean | 是否已提交成功，true：成功，false：失败 | true | |
| orderPlacedEvents | Array of Objects | 订单项 | orderPlacedEvents | |
| newOrderId | String | 主订单id | ||
| newOrderNo | String | 主订单NO | ||
| totalPrice | Double | 订单价格 |
表 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_upgrade
请求头header
无
请求体body
{
"resourceId": "xxxxxxx",
"ismain": "single",
"firewallEdition": "advanced"
}
响应示例
{
"statusCode": null,
"returnObj": {
"errorMessage": "",
"submitted": true,
"orderPlacedEvents": [
{
"errorMessage": "",
"submitted": true,
"newOrderId": "xxxxxxxxxx",
"newOrderNo": "202604xxxxxxxxx",
"totalPrice": 4327.01
}
]
}
}
状态码
请参考 状态码
错误码
请参考 错误码
