云服务器查询实例价格（按量计费）-API 文档-文档中心-腾讯云

说明：

当前页面接口为旧版 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"
        }
    }
}

查询实例价格（按量计费）

本页目录：

1. 接口描述

2. 输入参数

3. 输出参数

4. 示例