批量订购询价

接口说明

本接口用于云主机批量订购询价,获取主机和系统盘的总价。


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

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"
	}
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。