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