接口功能介绍
购买云产品时询价接口,支持云主机、云硬盘、弹性公网IP、NAT网关、共享带宽、物理机、性能保障型负载均衡、云主机备份存储库和云硬盘备份存储库产品的包年/包月或按量订单的询价功能
接口约束
无
URI
POST /v4/new-order/query-price
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 资源池ID | 41f64827f25f468595ffa3a5deb5d15d | |
resourceType | 是 | String | 资源类型 | VM | |
count | 是 | Integer | 订购数量 | 1 | |
onDemand | 是 | Boolean | 是否按需资源,true 按需 / false 包周期 | false | |
cycleType | 否 | String | 订购周期类型,当onDemand为false时为必填,可选值:MONTH 月/YEAR 年 | MONTH | |
cycleCount | 否 | Integer | 订购周期大小,订购周期类型为MONTH时范围[1,60],订购周期类型为YEAR时范围[1,5],当onDemand为false时为必填 | 6 | |
flavorName | 否 | String | 云主机规格,当resourceType为VM时必填 | s2.small.1 | |
imageUUID | 否 | String | 云主机镜像UUID,当resourceType为VM时必填 | 7d2922f3-019e-4dbb-ad84-cc8c3497546c | |
sysDiskType | 否 | String | 云主机系统盘类型,当resourceType为VM时必填 | SATA | |
sysDiskSize | 否 | Integer | 云主机系统盘大小,范围[40,2048],当resourceType为VM时必填 | 50 | |
disks | 否 | Array of Objects | 数据盘信息,当resourceType为VM选填,订购云主机时如果成套订购数据盘时需要该字段 | disks | |
bandwidth | 否 | Integer | 带宽大小,范围[1,2000],当resourceType为IP时必填;当resourceType为VM时,如果成套订购弹性公网IP时需要该字段 | 1 | |
diskType | 否 | String | 磁盘类型,当resourceType为EBS时必填 | SATA | |
diskSize | 否 | Integer | 磁盘大小,范围[5,2000],当resourceType为EBS时必填 | 30 | |
diskMode | 否 | String | 磁盘模式(VBD/ISCSI/FCSAN),当resourceType为EBS时必填 | VBD | |
natType | 否 | String | nat规格,当resourceType为NAT时必填 | small | |
ipPoolBandwidth | 否 | Integer | 共享带宽大小,范围[5,2000],当resourceType为IP_POOL时必填 | 6 | |
deviceType | 否 | String | 物理机规格,当resourceType为BMS时必填 | physical.t4.large | |
azName | 否 | String | 物理机规格可用区,当resourceType为BMS时必填 | az1 | |
orderDisks | 否 | Array of Objects | 物理机云硬盘信息,当resourceType为BMS选填 | orderDisks | |
elbType | 否 | String | 性能保障型负载均衡类型(支持standardI/standardII/enhancedI/enhancedII/higherI),当resourceType为PGELB时必填 | standardI | |
cbrValue | 否 | Integer | 存储库大小,100-1024000GB,当resourceType为CBR_VM或CBR_VBS时必填 | 100 |
表 disks
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
diskType | 是 | String | 磁盘类型 | SATA | |
diskSize | 是 | Integer | 磁盘大小 | 10 |
表 orderDisks
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
diskType | 是 | String | 磁盘类型 | SATA | |
diskSize | 是 | Integer | 磁盘大小 | 10 |
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回状态码(800为成功,900为失败) | 800 | |
errorCode | String | 具体错误码标志 | ||
message | String | 失败时的错误信息 | ||
description | String | 失败时的错误描述 | ||
returnObj | Object | 成功时返回的数据,参见returnObj对象结构 | ||
error | String | 错误码,为product.module.code三段式码。请求成功时不返回该字段 | Vm.OrderPrice.InvalidFlavor |
表 returnObj
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
totalPrice | Float | 总价格 | 336.0 | |
discountPrice | Float | 折后价格,云主机相关产品有 | 225.3 | |
finalPrice | Float | 最终价格 | 225.3 | |
subOrderPrices | Array of Objects | 子订单价格信息 | subOrderPrices |
表 subOrderPrices
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
serviceTag | String | 服务类型 | OVMS | |
totalPrice | Float | 子订单总价格 | 336.0 | |
orderItemPrices | Array of Objects | item价格信息 | orderItemPrices |
表 orderItemPrices
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
resourceType | String | 资源类型 | VM | |
totalPrice | Float | 总价格 | 246.0 | |
finalPrice | Float | 最终价格 | 135.3 |
枚举参数
参数名 resourceType
枚举值 | 类型 | 说明 |
---|---|---|
VM | String | 云主机 |
EBS | String | 云硬盘 |
IP | String | 弹性公网IP |
IP_POOL | String | 共享带宽 |
NAT | String | NAT网关 |
BMS | String | 物理机 |
PGELB | String | 性能保障型负载均衡 |
CBR_VM | String | 云主机备份存储库 |
CBR_VBS | String | 云硬盘备份存储库 |
参数名 磁盘类型diskType
枚举值 | 类型 | 说明 |
---|---|---|
SAS | String | 高IO |
SATA | String | 普通IO |
SSD | String | 超高IO |
SSD-genric | String | 通用型SSD |
FAST-SSD | String | 极速型SSD |
参数名 natType
枚举值 | 类型 | 说明 |
---|---|---|
small | String | 小型 |
medium | String | 中型 |
large | String | 大型 |
xlarge | String | 超大型 |
请求示例
请求url
无
请求头header
无
请求体body
包周期云主机单独下单询价:
{
"count": 1,
"sysDiskSize": 50,
"sysDiskType": "SATA",
"cycleCount": 6,
"onDemand": false,
"resourceType": "VM",
"regionID": "41f64827f25f468595ffa3a5deb5d15d",
"flavorName": "s2.small.1",
"cycleType": "MONTH",
"imageUUID": "7d2922f3-019e-4dbb-ad84-cc8c3497546c"
}
按需云主机单独下单询价:
{
"count": 1,
"sysDiskSize": 50,
"sysDiskType": "SATA",
"onDemand": true,
"imageUUID": "7d2922f3-019e-4dbb-ad84-cc8c3497546c",
"resourceType": "VM",
"regionID": "41f64827f25f468595ffa3a5deb5d15d",
"flavorName": "s2.small.1"
}
云主机成套下单询价:
{
"sysDiskSize": 50,
"sysDiskType": "SATA",
"cycleCount": 6,
"flavorName": "s2.small.1",
"bandwidth": 1,
"cycleType": "MONTH",
"count": 1,
"disks":
[
{
"diskSize": 10,
"diskType": "SATA"
}
],
"onDemand": false,
"resourceType": "VM",
"regionID": "41f64827f25f468595ffa3a5deb5d15d",
"imageUUID": "7d2922f3-019e-4dbb-ad84-cc8c3497546c"
}
包周期云硬盘下单询价:
{
"count": 1,
"cycleType": "MONTH",
"diskSize": 30,
"cycleCount": 6,
"onDemand": false,
"resourceType": "EBS",
"regionID": "41f64827f25f468595ffa3a5deb5d15d",
"diskMode": "VBD",
"diskType": "SATA"
}
包周期弹性公网IP下单询价:
{
"count": 1,
"cycleCount": 6,
"onDemand": false,
"resourceType": "IP",
"regionID": "41f64827f25f468595ffa3a5deb5d15d",
"bandwidth": 100,
"cycleType": "MONTH"
}
包周期共享带宽下单询价:
{
"count": 1,
"cycleCount": 6,
"onDemand": false,
"resourceType": "IP_POOL",
"regionID": "41f64827f25f468595ffa3a5deb5d15d",
"ipPoolBandwidth": 10,
"cycleType": "MONTH"
}
包周期NAT网关下单询价:
{
"count": 1,
"cycleCount": 6,
"onDemand": false,
"resourceType": "NAT",
"regionID": "41f64827f25f468595ffa3a5deb5d15d",
"natType": "small",
"cycleType": "MONTH"
}
包周期物理机下单询价:
{
"resourceType":"BMS",
"regionID":"bb9fdb42056f11eda1610242ac110002",
"azName":"cn-huadong1-jsnj1A-public-ctcloud",
"orderDisks":[
{
"diskType":"SATA",
"diskSize":205
}
],
"deviceType":"physical.s5.2xlarge4",
"bandwidth":1,
"cycleCount":6,
"cycleType":"MONTH",
"onDemand": false,
"count":1
}
性能保障型负载均衡下单询价:
{
"resourceType":"PGELB",
"elbType":"higherI",
"cycleCount":3,
"cycleType":"MONTH",
"onDemand": false,
"count":1,
"regionID":"200000001790"
}
包周期云主机备份存储库下单询价:
{
"resourceType":"CBR_VM",
"cbrValue":100,
"cycleCount":2,
"cycleType":"MONTH",
"onDemand": false,
"count":1,
"regionID":"200000001790"
}
响应示例
{
"returnObj": {
"discountPrice": 363.3,
"totalPrice": 474,
"isSucceed": true,
"subOrderPrices": [
{
"serviceTag": "OVMS",
"totalPrice": 474,
"orderItemPrices": [
{
"itemId": "08f5565e80a311e7b63fa0369f9f6a76",
"resourceType": "VM",
"totalPrice": 246,
"finalPrice": 135.3
},
{
"itemId": "956a23cd50214c4b8ddd507dbc6be5ae",
"resourceType": "EBS",
"totalPrice": 90,
"finalPrice": 90
},
{
"itemId": "4092314281f94139b0d1693db96d662a",
"resourceType": "NETWORK",
"totalPrice": 120,
"finalPrice": 120
},
{
"itemId": "956a23cd50214c4b8ddd507dbc6be5ae",
"resourceType": "EBS",
"totalPrice": 18,
"finalPrice": 18
}
],
"finalPrice": 363.3
}
],
"finalPrice": 363.3
},
"message": "",
"errorCode": "",
"description": "",
"statusCode": 800
}
状态码
请参考 状态码
错误码
请参考 错误码