说明：当前页面接口为旧版 API，未来可能停止维护，目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范，访问时延下降显著，建议使用 云服务器 API 3.0。
1. 接口描述
本接口 (InquiryInstancePriceHour) 用于获取实例价格(按量计费)。
接口请求域名：cvm.api.qcloud.com
仅支持按量计费实例的价格查询，包年包月实例使用 InquiryInstancePrice。
2. 输入参数
以下请求参数列表仅列出了接口请求参数，其它参数见 公共请求参数 页面。
- 参数存在具体的范围限制。欲获取更详细的参数信息。用户可以参考 RunInstances。
| 参数名称 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| cpu | 是 | Int | 实例核数。CPU与内存具体的配比限制参见 实例规格。 |
| mem | 是 | Int | 实例内存大小(GB)。CPU与内存具体的配比限制参见 实例规格。 |
| imageId | 是 | String | 镜像ID。可通过 查询镜像 接口（链接包含公共镜像名称ID对应表）返回字段中的 unImgId 获取。 |
| imageType | 是 | Int | 镜像类型。 1：私有镜像、2：公共镜像、3：服务市场、4：共享镜像。imageType 必须要 imageid 实际类型匹配。 |
| bandwidthType | 否 | String | 带宽的类型。PayByHour：按带宽使用时长计费 PayByTraffic：按流量计费。 默认为按使用时长计费。网络计费模式的区别可以参看 购买网络带宽。 |
| bandwidth | 否 | Int | 公网带宽(Mbps)，当按流量计费时为公网带宽峰值。默认为0。 |
| storageSize | 是 | Int | 数据盘大小(GB)。步长为10，0表示不要数据盘。关于数据盘的最大大小请参考 云硬盘。 |
| storageType | 否 | Int | 数据盘类型。1：本地硬盘、2：普通云硬盘，默认为本地硬盘。关于数据盘的类型选择请参考 云硬盘。 |
| goodsNum | 否 | Int | 购买实例数量。默认为1，最大100。 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| code | Int | 公共错误码。0表示成功，其他值表示失败。详见错误码页面的 公共错误码。 |
| message | String | 模块错误信息描述，与接口相关。 |
| data | Array | 返回列表 |
Data列表结构
| 参数名称 | 类型 | 描述 |
|---|---|---|
| bandwidth | Array | 带宽详细。 |
| cvm | Array | 实例详细。 |
CVM、bandwidth列表结构
| 参数名称 | 类型 | 描述 |
|---|---|---|
| price | String | 价格。 |
| price_unit | String | 价格单位。 |
4. 示例
输入
https://cvm.api.qcloud.com/v2/index.php?Action=InquiryInstancePriceHour &cpu=1 &mem=1 &bandwidthType=PayByTraffic &bandwidth=2 &storageSize=10 &<公共请求参数>
输出
{
"code": 0,
"message": "",
"data": {
"cvm": {
"price": "0.28",
"price_unit": "HOUR"
},
"bandwidth": {
"price": "1.60",
"price_unit": "GB"
}
}
}