接口说明
本接口用于云主机批量订购询价,获取主机和系统盘的总价。
URL
POST https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/query/price
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
serverPriceQueryRequest
|
询价请求结构体
|
是
|
批量询价请求体。 |
|
productType
|
string
|
是
|
产品类型:vm-云主机/ironic-裸金属服务器。 |
|
flavorId
|
string
|
否
|
规格id,格式如"ecloud-normal-5118-0.5-000100010020",此项与规格名称二选一,如果都填,以flavorId为准。 |
|
specsName
|
string
|
否
|
规格名称,格式如"s1.medium.1",和规格id二选一,如果都填,以flavorId为准。 |
|
bootVolume
|
BootVolume
|
否
|
系统盘查询参数。 |
|
size
|
integer(int32)
|
是
|
系统盘大小(GB),大小需在[20,1024]间。 |
|
volumeType
|
enum(highPerformance,performanceOptimization,highPerformanceyc,performanceOptimizationyc)
|
是
|
系统盘类型,highPerformance:高性能型;highPerformanceyc:高性能型-云创;performanceOptimization:性能优化型;performanceOptimizationyc:性能优化型-云创。 |
|
quantity
|
integer(int32)
|
否
|
订购数量,不填默认为1,不超过10。 |
|
duration
|
integer(int32)
|
否
|
订购时长,不填默认为1,包月最大12,包年最大5。 |
|
feeUnit
|
string
|
是
|
缴费周期类型(month/year/hour)。 |
请求示例
POST https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/query/price
{
"body":{
"productType":"vm",
"specsName":"c5.large.2",
"feeUnit":"hour"
}
}
返回参数
返回码:200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
询价请求响应结构体
|
请求成功时返回的数据 |
|
serverPrice
|
string
|
服务器总价 |
|
bootVolumePrice
|
string
|
系统盘总价 |
|
errorCode
|
string
|
统一错误码 |
|
errorMessage
|
string
|
页面国际化错误提示 |
|
errorParams
|
<string> array
|
统一错误码的自定义参数 |
|
requestId
|
string
|
每个请求的序列号 |
|
state
|
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)
|
返回状态码;返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN |
返回示例
返回码:200
OK
{
"requestId":"reqId-9ff021hg5403f6gd46284d-2c3w47d0-0",
"state":"OK",
"body":{
"serverPrice":"0.4100"
}
}