说明:
1. 接口描述
本接口 (InquiryPriceResizeInstanceDisks) 用于扩容实例的数据盘询价。
接口请求域名:cvm.api.qcloud.com
目前只支持扩容随实例购买的数据盘询价,且数据盘类型为:
CLOUD_BASIC
、CLOUD_PREMIUM
、CLOUD_SSD
。目前不支持 CDH 实例使用该接口扩容数据盘询价。
仅支持包年包月实例随机器购买的数据盘。
目前只支持扩容一块数据盘询价。
2. 输入参数
名称 | 类型 | 是否必选 | 描述 |
Version | String | 是 | 表示 API 版本号,主要用于标识请求的不同 API 版本。 本接口第一版本可传:2017-03-12。 |
InstanceId | String | 是 | |
DataDisks.N | 是 | 待扩容的数据盘配置信息。只支持扩容随实例购买的数据盘,且数据盘类型为: CLOUD_BASIC 、CLOUD_PREMIUM 、CLOUD_SSD 。数据盘容量单位:GB。最小扩容步长:10G。关于数据盘类型的选择请参考硬盘产品简介。可选数据盘类型受到实例类型InstanceType 限制。另外允许扩容的最大容量也因数据盘类型的不同而有所差异。 | |
ForceStop | Boolean | 否 | 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再重置用户密码。取值范围: TRUE:表示在正常关机失败后进行强制关机 FALSE:表示在正常关机失败后不进行强制关机 默认取值:FALSE。 强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 |
3. 输出参数
参数名称 | 类型 | 描述 |
Price | 该参数表示磁盘扩容成对应配置的价格。 | |
RequestId | String | 唯一请求 ID。每次请求都会返回一个唯一的 requestId,当客户调用接口失败找后台研发人员处理时需提供该requestId具体值。 |
4. 错误码
错误码 | 描述 |
MissingParameter | 参数缺失。请求没有带必选参数。 |
InvalidInstanceId.NotFound | 无效实例 ID 。指定的实例ID 不存在。 |
InvalidInstanceId.Malformed | 无效实例 ID 。指定的实例ID 格式错误。例如ID 长度错误ins-1122 。 |
InvalidParameterValue | 无效参数值。参数值格式错误或者参数值不被支持等。 |
InvalidInstance.NotSupported | 实例不支持该操作。 |
InvalidAccount.InsufficientBalance | 账户余额不足。 |
InvalidAccount.UnpaidOrder | 账户有未支付订单。 |
InternalServerError | 操作内部错误。 |
5. 示例
示例1
包年包月实例扩容磁盘询价:
请求参数
https://cvm.api.qcloud.com/v2/index.php?Action=InquiryPriceResizeInstanceDisks&Version=2017-03-12&InstanceId=ins-r8hr2upy&DataDisks.0.DiskSize=100
返回参数
{"Response": {"Price": {"InstancePrice": {"OriginalPrice": "15.78","DiscountPrice": "15.78"}},"RequestId": "0b30b426-c4fa-4f48-819b-7dd5529f7e05"}}
示例2
按量付费实例扩容磁盘询价:
请求参数
https://cvm.api.qcloud.com/v2/index.php?Action=InquiryPriceResizeInstanceDisks&InstanceId=ins-fd8spnmq&DataDisks.0.DiskSize=100
返回参数
{"Response": {"Price": {"InstancePrice": {"UnitPrice": 0.46,"ChargeUnit": "HOUR"}},"RequestId": "d63b4f53-335b-49fb-9aa1-1716bb9276f6"}}