操作指南

最佳实践

运维指南

API 文档

查询实例价格(按量计费)

最近更新时间:2019-09-11 16:10:33

说明:

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