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

最近更新时间:2019-04-29 17:57:36

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

1. 接口描述

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

接口请求域名:cvm.api.qcloud.com

2. 输入参数

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

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

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

用于续费

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

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

  • 参数存在具体的范围限制。欲获取更详细的参数信息,用户可以参考此API
参数名称 是否必选 类型 描述
instanceType Int 实例类型,此处为1(CVM实例购买)。
instanceModel String 实例类型(例如高IO机型等)。默认为CVM.S1。更多实例类型,可在“创建实例”中查看“实例类型”一节。
cpu Int 实例核数。CPU与内存具体的配比限制参见CVM实例配置
mem Int 实例内存大小(GB)。CPU与内存具体的配比限制参见CVM实例配置
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. 查询实例配置升级的价格

  • 参数存在具体的范围限制。欲获取更详细的参数信息,用户可以参考此API
参数名称 是否必选 类型 描述
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. 查询升级实例时间段内网络的价格

  • 参数存在具体的范围限制。欲获取更详细的参数信息,用户可以参考此API
参数名称 是否必选 类型 描述
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. 错误码

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

错误码 描述
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
}