查询续订订单价格(N100型)
更新时间 2026-04-17 15:57:29
最近更新时间: 2026-04-17 15:57:29
接口功能介绍
续订云防火墙（原生版）-N100型产品的包年/包月的询价功能
接口约束
无
URI
POST /v1/cngfw/order/query_renew_price
路径参数 无
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 | ||
| resourceIds | 是 | String of Array(String) | 资源id数组，包含云防火墙（原生版）资源id、云主机资源id |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 状态码，800：成功，900：失败 | ||
| message | String | 返回信息 | 成功 | |
| error | String | 错误信息 | ||
| returnObj | Object | 接口返回结果 | returnObj | |
| errorCode | String | 错误码 |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| isSuccess | Boolean | 询价是否成功，true：成功，false：失败 | ||
| totalPrice | Double | 总价格，单位CNY | 336.0 | |
| finalPrice | Double | 最终价格，单位CNY | 225.3 | |
| discountRate | Double | 折扣 | ||
| subOrderPrices | Array of Objects | 订单项价格 | subOrderPrices |
表 subOrderPrices
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| totalPrice | Double | 总价格，单位CNY | 336.0 | |
| finalPrice | Double | 最终价格，单位CNY | 225.3 | |
| serviceTag | String | 服务标签 | CFW | |
| cycleCount | String | 订购周期数 | ||
| orderItemPrices | Array of Objects | 订单项明细价格 | orderItemPrices |
表 orderItemPrices
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| itemId | String | 订单明细项id | ||
| resourceType | String | 资源类型 | CFW_VERSION | |
| ctyunName | String | 产品名称 | 云防火墙（原生版） | |
| instanceCnt | String | 规格数量 | 1.0 | |
| totalPrice | Double | 总价格，单位CNY | ||
| finalPrice | Double | 最终价格，单位CNY |
枚举参数
参数名 statusCode
| 枚举值 | 类型 | 说明 |
|---|---|---|
| 800 | Integer | 成功 |
| 900 | Integer | 失败 |
请求示例
请求url
https://ctcfw-global.ctapi.ctyun.cn/v1/cngfw/order/query_renew_price
请求头header
无
请求体body
{
"cycleCount": 1,
"cycleType": 3,
"resourceIds": ["xxxxxxxx","xxxxxxxx"]
}
响应示例
{
"statusCode": 800,
"returnObj": {
"isSucceed": true,
"totalPrice": 1530.0,
"finalPrice": 1530.0,
"subOrderPrices": [
{
"totalPrice": 1300.0,
"finalPrice": 1300.0,
"serviceTag": "CFW",
"cycleCount": 1,
"orderItemPrices": [
{
"itemId": "73935520c07e4d2da3b918fe9b6cb8ba",
"resourceType": "CFW_VERSION",
"ctyunName": "云防火墙（原生版）",
"instanceCnt": "1.0",
"totalPrice": 1300.0,
"finalPrice": 1300.0
}
]
},
{
"totalPrice": 230.0,
"finalPrice": 230.0,
"serviceTag": "OVMS",
"cycleCount": 1,
"orderItemPrices": [
{
"itemId": "c0c892edc3ce4367b8586b8854f32c8b",
"resourceType": "VM",
"ctyunName": "弹性云主机",
"instanceCnt": "1.0",
"totalPrice": 202.0,
"finalPrice": 202.0
},
{
"itemId": "df87347a510e4f09bee5960c0f1e0bfb",
"resourceType": "EBS",
"ctyunName": "云硬盘",
"instanceCnt": "40.0",
"totalPrice": 28.0,
"finalPrice": 28.0
}
]
}
]
}
}
状态码
请参考 状态码
错误码
请参考 错误码
