查询新购订单价格(N100型)
更新时间 2026-04-17 15:57:37
最近更新时间: 2026-04-17 15:57:37
接口功能介绍
新购买云防火墙(原生版)-N100型产品的包年/包月的询价功能
接口约束
无
URI
POST /v1/cngfw/order/query_newPurchase_price
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| orders | 是 | Array of Objects | 新购订单询价参数信息 示例: | orders |
表 orders
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| 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 | |
| items | 是 | Array of Objects | 订单项信息 | items |
表 items参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| master | 是 | Boolean | 是否为主资源 当resourceType=CFW_VERSION/VM时,固定传参:true 其他资源固定传参:false | true | |
| resourceType | 是 | String | 资源类型,取值范围如下: 自研池资源类型: CFW_VERSION-云防火墙(原生版),VM-虚拟云主机,EBS-磁盘,NETWORK-带宽 合营池资源类型: CFW_VERSION-云防火墙(原生版),VMC-虚拟云主机,EBSC-磁盘,NETWORKC-带宽 | CFW_VERSION | |
| serviceTag | 是 | String | 服务标签 CFW:云防火墙(原生版) 自研池虚拟云主机、磁盘、带宽,固定传值:OVMS 合营池虚拟云主机、磁盘、带宽,固定传参:HWS | CFW | |
| itemValue | 是 | Integer | 规格数量 当resourceType=CFW_VERSION/VM时,表示数量,固定传参:1 当resourceType=NETWORK时,表示带宽大小 当resourceType=EBS,表示磁盘容量大小 | 1 | |
| isSystemVolume | 否 | Boolean | 是否系统盘,取值范围:true,当resourceType=EBS传参。注:若购买了主机则必须一起新购系统盘 | ||
| itemConfig | 是 | Object | 订单项配置信息,不同订单项对应不同的itemConfig | itemConfig |
表 itemConfig(云防火墙(原生版)订单项)
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| deployMode | 是 | String | 云防火墙部署方式,取值范围:single-单机部署,dual-主备部署 item为云防火墙订单项时传参 | single | |
| firewallEdition | 是 | String | 云防火墙公网处理能力(版本),取值范围:standard-100Mbps,advanced-200Mbps,ultimated-2Gbps item为云防火墙(原生版)订单项时传参 | standard | |
| regionId | 否 | String | 资源池id |
表 itemConfig(云主机订单项-云主机)
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池id | ||
| azName | 是 | String | 可用区编码,若资源池无可用区时传:default | cn-xinan1-2A | |
| vpcId | 否 | String | vpc Id | ||
| subnetId | 否 | String | 子网id | ||
| zoneId | 否 | String | 区域id,值同regionId | ||
| zoneType | 是 | String | 是否为蒙贵资源池,1:蒙贵,2:非蒙贵 | 2 | |
| cpuNum | 是 | String | CPU核数,取值范围:[2,4,8,16] | 2 | |
| memSize | 是 | String | 内存大小,取值范围:[4,8,16,32] | 4 | |
| flavorType | 是 | String | 云主机规格类型 自研池查询云主机规格列表 | CPU_S7 | |
| flavorUuid | 否 | String | 云主机规格id | ||
| flavorRef | 否 | String | 合营池云主机规格名称,资源池为合营池时必传 | c7.large.2 | |
| sysVolumeSize | 是 | String | 系统盘大小(G),取值范围:40-1000 | 40 | |
| version | 否 | String | 云主机销售品版本,取值范围:[v1,v2] 注:自研池时必传 | v1 |
表 itemConfig(云主机订单项-云硬盘)
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池id | ||
| azName | 是 | String | 可用区编码,若资源池无可用区时传:default | ||
| volumeType | 是 | String | 云硬盘类型 | SATA | |
| volumeSize | 是 | Integer | 云硬盘大小 | ||
| sysDisk | 是 | Integer | 是否系统盘,固定传参:1 | 1 | |
| version | 否 | String | 云主机销售品版本,取值范围:[v1,v2] 注:自研资源池时必传 | v1 | |
| dataVolumes | 否 | String | 云硬盘信息 | dataVolumes |
表 dataVolumes
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| type | 是 | String | 云硬盘类型 | ||
| size | 是 | Integer | 云硬盘大小 |
表 itemConfig(带宽订单项)
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| type | 是 | String | 带宽类型,固定传参:standalone | ||
| ipVersion | 是 | String | 带宽版本,固定传参:4 | ||
| size | 是 | Integer | 带宽大小,取值范围:2-300,最小2M,最大300M | 2 | |
| name | 否 | String | 带宽名称,取值范围:1-64,支持数字、字母、中文、_(下划线)、-(中划线) | ||
| regionId | 是 | String | 资源池id | ||
| azName | 是 | String | 可用区编码,若资源池无可用区时传:default |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| 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 | 失败 |
参数名 resourceType
| 枚举值 | 类型 | 说明 |
|---|---|---|
| CFW_VERSION | String | 云防火墙(原生版)-全局 |
| VM | String | 虚拟云主机-自研池 |
| EBS | String | 云硬盘-自研池 |
| NETWORK | String | 带宽-自研池 |
| VMC | String | 云硬盘-合营池 |
| EBSC | String | 云硬盘-合营池 |
| NETWORKC | String | 带宽-合营池 |
参数名 serviceTag
| 枚举值 | 类型 | 说明 |
|---|---|---|
| CFW | String | 云防火墙产品 |
| OVMS | String | 自研池IaaS产品 |
| HWS | String | 合营池IaaS产品 |
请求示例
请求url
https://ctcfw-global.ctapi.ctyun.cn/v1/cngfw/order/query_newPurchase_price
请求头header
无
请求体body
# (云防火墙(原生版)单机部署方式 + 云主机(一台) + 云硬盘 + 独享带宽)
{
"orders": [
{
"instanceCnt": 1,
"cycleCnt": 1,
"cycleType": 3,
"items": [
{
"master": true,
"resourceType": "CFW_VERSION",
"serviceTag": "CFW",
"itemValue": 1,
"itemConfig": {
"regionId":"资源池id",
"firewallEdition": "standard",
"ismain": "single"
}
}
]
},
{
"instanceCnt": 1,
"cycleCnt": 1,
"cycleType": 3,
"items": [
{
"master": true,
"resourceType": "VM",
"serviceTag": "OVMS",
"itemConfig": {
"regionId": "资源池id",
"vpcId": "vpc id",
"subnetId": "子网id",
"zoneType": "2",
"azName": "可用区名称",
"cpuNum": "2",
"memSize": "4",
"flavorType": "云主机规格类型",
"sysVolumeSize": 40,
"version": "v2"
},
"itemValue": 1
},
{
"master": false,
"resourceType": "EBS",
"serviceTag": "OVMS",
"isSystemVolume": true,
"itemConfig": {
"volumeSize": 40,
"volumeType": "SSD-genric",
"version": "v2",
"syshd": 1,
"regionId": "资源池id",
"azName": "可用区名称"
},
"itemValue": 40
},
{
"master": false,
"resourceType": "NETWORK",
"serviceTag": "OVMS",
"itemConfig": {
"type": "standalone",
"ipVersion": "4",
"size": 2,
"regionId": "资源池id",
"azName": "可用区名称"
},
"itemValue": 2
}
]
}
]
}
# (云防火墙(原生版)主备部署方式 + 云主机(两台) + 云硬盘 + 独享带宽)
{
"orders": [
{
"instanceCnt": 1,
"cycleCnt": 1,
"cycleType": 3,
"items": [
{
"master": true,
"resourceType": "CFW_VERSION",
"serviceTag": "CFW",
"itemValue": 1,
"itemConfig": {
"regionId":"资源池id",
"firewallEdition": "standard",
"ismain": "single"
}
}
]
},
{
"instanceCnt": 1,
"cycleCnt": 1,
"cycleType": 3,
"items": [
{
"master": true,
"resourceType": "VM",
"serviceTag": "OVMS",
"itemConfig": {
"regionId": "资源池id",
"vpcId": "vpc id",
"subnetId": "子网id",
"zoneType": "2",
"azName": "可用区名称",
"cpuNum": "2",
"memSize": "4",
"flavorType": "云主机规格类型",
"sysVolumeSize": 40,
"version": "v2"
},
"itemValue": 1
},
{
"master": false,
"resourceType": "EBS",
"serviceTag": "OVMS",
"isSystemVolume": true,
"itemConfig": {
"volumeSize": 40,
"volumeType": "SSD-genric",
"version": "v2",
"syshd": 1,
"regionId": "资源池id",
"azName": "可用区名称"
},
"itemValue": 40
},
{
"master": false,
"resourceType": "NETWORK",
"serviceTag": "OVMS",
"itemConfig": {
"type": "standalone",
"ipVersion": "4",
"size": 2,
"regionId": "资源池id",
"azName": "可用区名称"
},
"itemValue": 2
}
]
},
{
"instanceCnt": 1,
"cycleCnt": 1,
"cycleType": 3,
"items": [
{
"master": true,
"resourceType": "VM",
"serviceTag": "OVMS",
"itemConfig": {
"regionId": "资源池id",
"vpcId": "vpc id",
"subnetId": "子网id",
"zoneType": "2",
"azName": "可用区名称",
"cpuNum": "2",
"memSize": "4",
"flavorType": "云主机规格类型",
"sysVolumeSize": 40,
"version": "v2"
},
"itemValue": 1
},
{
"master": false,
"resourceType": "EBS",
"serviceTag": "OVMS",
"isSystemVolume": true,
"itemConfig": {
"volumeSize": 40,
"volumeType": "SSD-genric",
"version": "v2",
"syshd": 1,
"regionId": "资源池id",
"azName": "可用区名称"
},
"itemValue": 40
},
{
"master": false,
"resourceType": "NETWORK",
"serviceTag": "OVMS",
"itemConfig": {
"type": "standalone",
"ipVersion": "4",
"size": 2,
"regionId": "资源池id",
"azName": "可用区名称"
},
"itemValue": 2
}
]
}
]
}
响应示例
{
"statusCode": 800,
"returnObj": {
"isSucceed": true,
"totalPrice": 2937.24,
"finalPrice": 2937.24,
"subOrderPrices": [
{
"totalPrice": 337.24,
"finalPrice": 337.24,
"serviceTag": "OVMS",
"cycleCount": 2,
"orderItemPrices": [
{
"itemId": "XXXXXXXX",
"resourceType": "VM",
"ctyunName": "弹性云主机ECS",
"instanceCnt": "1.0",
"totalPrice": 313.24,
"finalPrice": 313.24
},
{
"itemId": "XXXXXXXX",
"resourceType": "EBS",
"ctyunName": "云硬盘",
"instanceCnt": "40.0",
"totalPrice": 24.0,
"finalPrice": 24.0
},
{
"itemId": "xxxxxxxx",
"resourceType": "NETWORK",
"ctyunName": "弹性IP",
"instanceCnt": "2.0",
"totalPrice": 40,
"finalPrice": 40
}
]
},
{
"totalPrice": 2600.0,
"finalPrice": 2600.0,
"serviceTag": "CFW",
"cycleCount": 2,
"orderItemPrices": [
{
"itemId": "XXXXXXXX",
"resourceType": "CFW_VERSION",
"ctyunName": "云防火墙(原生版)",
"instanceCnt": "1.0",
"totalPrice": 2600.0,
"finalPrice": 2600.0
}
]
}
]
}
}
状态码
请参考 状态码
错误码
请参考 错误码