询价

接口说明


查询实例及系统盘资源的最新价格。


推荐使用API Explorer调试

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

URL

POST https://ecloud.10086.cn/api/openapi-instance/v4/describe-price

请求参数

Body

参数名称
类型
必填
描述
describePriceReq
DescribePrice
是

describePriceReq

productType
string
是

产品类型。取值范围:

  • vm:云主机。
flavorName
string
是

规格名称,您可以通过查询实例可用规格列表获取。

bootVolume
BootVolume
否

系统盘查询参数。

size
integer(int32)
是

系统盘大小(GB),大小需在[20,1024]间。

volumeType
string
是

系统盘类型。详细请参考系统盘类型。

quantity
integer(int32)
否

订购数量。默认值为1,最大值为10。

duration
integer(int32)
否

订购时长。取值范围:

  • 若feeUnit为month,duration取值为[1,12]。
  • 若feeUnit为year,duration取值为[1,5]
  • 若feeUnit为hour,duration无需填写。

默认值:1。

feeUnit
string
是

缴费周期类型。取值范围:

  • month:包月。
  • year:包年。
  • hour:按量。

请求示例

POST https://ecloud.10086.cn/api/openapi-instance/v4/describe-price
{
	"productType":"vm",
	"flavorName":"c5.large.2",
	"bootVolume":{
		"size":20,
		"volumeType":"highPerformance"
	},
	"feeUnit":"month"
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
ServerPriceQuery

请求成功时返回的数据。

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-24c7f2dc476a56ee4b15314eb5202f47",
	"state":"OK",
	"body":{
		"serverPrice":"194.0000",
		"bootVolumePrice":"20.0000"
	}
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。