云服务器查询实例价格（包年包月）

说明：
当前页面接口为旧版 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
}
﻿

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

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

查询实例价格（包年包月）

本页目录：

1. 接口描述

2. 输入参数

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

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

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

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

3. 输出参数

4. 错误码

5. 示例