查询实例价格(包年包月)

最近更新时间:2019-12-03 17:12:33

说明:

当前页面接口为旧版 API,未来可能停止维护,目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 云服务器 API 3.0

1. 接口描述

本接口 (InquiryInstancePrice) 用于获取实例价格(包年包月)。

接口请求域名:cvm.api.qcloud.com
仅支持包年包月实例的价格查询,按量计费实例使用 InquiryInstancePriceHour

2. 输入参数

以下请求参数列表仅列出了接口请求参数,其它参数见 公共请求参数 页面。

不同的产品输入参数也不一样。具体是:

2.1. 查询已购买成功的包月实例的价格

用于续费

参数名称 是否必选 类型 描述 来源
instanceType Int 实例类型 系统规定,CVM实例为1。
instanceId String 待操作的实例ID 可通过 DescribeInstances 接口返回字段中的 unInstanceId 获取。
period Int 购买或续费时长 用户自定义,单位月。最大为36,最小为1。

2.2. 查询包年包月实例价格

  • 参数存在具体的范围限制。欲获取更详细的参数信息,用户可以参考 RunInstances
参数名称 是否必选 类型 描述
instanceType Int 实例类型,此处为1(CVM 实例购买)。
instanceModel String 实例类型(例如高 IO 机型等)。默认为CVM.S1。更多实例类型,可在“创建实例”中查看“实例类型”一节。
cpu Int 实例核数。CPU与内存具体的配比限制参见 实例规格
mem Int 实例内存大小(GB)。CPU与内存具体的配比限制参见 实例规格
period Int 购买时长(月)。最少1个月,最多为36个月。
storageType Int 硬盘类型。1:本地硬盘、2:普通云硬盘、3:本地SSD硬盘、4:SSD云硬盘,默认为本地硬盘。关于数据盘的类型选择请参考 云硬盘
storageSize Int 数据盘大小(GB)。步长为10,为0表示不要数据盘,数据盘类型与 storageType 所指定的一致。关于数据盘的最大大小请参考 云硬盘
goodsNum Int 购买实例的数量。默认为1,最大 100。
bandwidth Int 公网带宽(Mbps),当按流量计费时为公网带宽峰值,默认为0。
bandwidthType String 带宽的类型。PayByTraffic:按流量计费; PayByBandwidth:按月计费;默认是按月计费。网络计费模式的区别可以参看 公网计费模式
rootSize Int 系统盘大小(单位:GB)。
Linux系统调整范围为20-50G,步长为1,默认为20G。
Windows不可调整,默认为50G。
系统盘类型与数据盘类型一致。
imageType Int 镜像类型。 1:私有镜像、2:公共镜像、3:服务市场、4: 共享镜像。imageType 必须要 imageid 实际类型匹配。
imageId String 镜像ID。可通过 查询镜像 接口(链接包含公共镜像名称 ID 对应表)返回字段中的 unImgId 获取。

2.3. 查询实例配置升级的价格

参数存在具体的范围限制。欲获取更详细的参数信息,用户可以参考 ResizeInstance

参数名称 是否必选 类型 描述
instanceType Int 实例类型,此处为4(CVM 实例配置升级)。
bandwidth Int 升级后的带宽值(Mbps)。
bandwidthUpgradeStartTime String 起始时间。格式如:2014-10-30,该时间不能早于当前时间。
bandwidthUpgradeEndTime String 终止时间。格式如:2014-11-30,该时间不能晚于实例购买的截止期限的时间。
cpu Int CPU 核数。升级后的核数。
mem Int 内存。 升级后的内存大小(GB)。
storageType Int 数据盘类型。1:本地硬盘、2:普通云硬盘、3:本地SSD硬盘、4:SSD云硬盘。
storageSize Int 升级后的数据盘大小。单位GB,为0表示不要数据盘。

2.4. 查询升级实例时间段内网络的价格

参数存在具体的范围限制。欲获取更详细的参数信息,用户可以参考 UpdateInstanceBandwidth

参数名称 是否必选 类型 描述
instanceType Int 实例类型,此处为5(CVM实例网络升级)。
instanceId String 待操作实例的实例ID。 可通过 DescribeInstances 接口返回字段中的 unInstanceId、instanceId 获取(建议使用 unInstanceId )。
bandwidth Int 升级后的带宽值(Mbps)。
startTime String 起始时间。格式如:2014-10-30,该时间不能早于当前时间。
endTime String 终止时间。格式如:2014-11-30,该时间不能晚于实例购买的截止期限的时间。

3. 输出参数

参数名称 类型 描述
code Int 公共错误码。0表示成功,其他值表示失败。详见错误码页面的 公共错误码
message String 模块错误信息描述,与接口相关。
price Int 产品的折扣价格,单位分。
originalPrice Int 产品的原价格,单位分。

4. 错误码

以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见 错误码 页面。

错误码 描述
NotSupport.NotPrepaidUser 请求被拒绝,接口只支持预付费用户。
OperationFail.AllResourceOpFailed 资源操作失败。
NotSupport.SharedInstance 共享核实例不支持续费询价。
InvalidParameter.ResourceNotFound 资源不存在。
PermissionDenied 您没有权限调整本地硬盘类型系统盘的大小,请联系官方客服。
PermissionDenied 您没有权限调整云硬盘类型系统盘的大小,请联系官方客服。
InvalidParameter.MissImageId 系统盘调整必须传 imageId。
NotSupport.InstanceConfig 请求失败,共享核实例不支持调整配置。
NotSupport.BandwidthPackageUser 请求失败,带宽包客户不支持使用该接口调整实例的带宽。
InvalidParameter.Bandwidth 售卖系统接口操作失败:bandwidth 参数不正确,请确认重试。

5. 示例

输入

  https://cvm.api.qcloud.com/v2/index.php?Action=InquiryProductPrice
  &instanceType=1
  &imageId=img-1234test
  &cpu=1
  &mem=1
  &storageSize=10
  &period=1
  &<公共请求参数>

输出

{
    "code":0,
    "message": "",
    "price": 1085,
    "originalPrice": 1085
}