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

最近更新时间:2017-11-29 22:46:24

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
}