接口功能介绍
支持云主机、云硬盘、弹性公网IP、NAT网关、共享带宽、物理机、性能保障型负载均衡、云主机备份存储库和云硬盘备份存储库产品的包年/包月订单的续订询价功能
接口约束
无
URI
POST /v4/renew-order/query-price
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 资源池ID | 41f64827f25f468595ffa3a5deb5d15d | |
resourceType | 是 | String | 资源类型 | VM | |
resourceID | 是 | String | 资源ID | 6ff3103f8daf41839d13dafa55e981c1 | |
cycleType | 是 | String | 订购周期类型,可选值:MONTH 月,YEAR 年 | MONTH | |
cycleCount | 是 | Integer | 订购周期大小,订购周期类型为MONTH时范围[1,36],订购周期类型为YEAR时范围[1,3] | 1 |
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回状态码(800为成功,900为失败) | 800 | |
errorCode | String | 具体错误码标志 | ||
message | String | 失败时的错误信息 | ||
description | String | 失败时的错误描述 | ||
returnObj | Object | 成功时返回的数据,参见returnObj对象结构 | returnObj | |
error | String | 错误码,为product.module.code三段式码。请求成功时不返回该字段 | Unknown.OrderPrice.ResourceNotExist |
表 returnObj对象
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
totalPrice | Float | 总价格 | 56.0 | |
finalPrice | Float | 最终价格 | 56.0 | |
subOrderPrices | Array of Objects | 子订单价格信息 | subOrderPrices |
表 subOrderPrices
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
serviceTag | String | 服务类型 | OVMS | |
totalPrice | Float | 总价格 | 56.0 | |
finalPrice | Float | 最终价格 | 56.0 | |
orderItemPrices | Array of Objects | 资源价格信息 | orderItemPrices |
表 orderItemPrices
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
resourceType | String | 资源类型 | VM | |
totalPrice | Float | 总价格 | 41.0 | |
finalPrice | Float | 最终价格 | 41.0 |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
{
"cycleType": "MONTH",
"cycleCount": 1,
"resourceType": "VM",
"resourceID": "6ff3103f8daf41839d13dafa55e981c1",
"regionID": "41f64827f25f468595ffa3a5deb5d15d"
}
响应示例
{
"returnObj": {
"totalPrice": 56,
"isSucceed": true,
"subOrderPrices": [
{
"serviceTag": "OVMS",
"totalPrice": 56,
"orderItemPrices": [
{
"itemId": "08f5565e80a311e7b63fa0369f9f6a76",
"resourceType": "VM",
"totalPrice": 41,
"finalPrice": 41
},
{
"itemId": "956a23cd50214c4b8ddd507dbc6be5ae",
"resourceType": "EBS",
"totalPrice": 15,
"finalPrice": 15
}
],
"finalPrice": 56
}
],
"finalPrice": 56
},
"message": "",
"errorCode": "",
"description": "",
"statusCode": 800
}
状态码
请参考 状态码
错误码
请参考 错误码