热门活动
全部活动
说明：
1. 接口描述
本接口 (InquiryPriceResetInstancesInternetMaxBandwidth) 用于调整实例公网带宽上限询价。
接口请求域名：cvm.api.qcloud.com
不同机型带宽上限范围不一致，具体限制详见 公网计费模式。
对于
BANDWIDTH_PREPAID计费方式的带宽，需要输入参数StartTime和EndTime，指定调整后的带宽的生效时间段。在这种场景下目前不支持调小带宽，会涉及扣费，请确保账户余额充足。可通过 DescribeAccountBalance 接口查询账户余额。对于
TRAFFIC_POSTPAID_BY_HOUR、 BANDWIDTH_POSTPAID_BY_HOUR 和 BANDWIDTH_PACKAGE 计费方式的带宽，使用该接口调整带宽上限是实时生效的，可以在带宽允许的范围内调大或者调小带宽，不支持输入参数 StartTime 和 EndTime 。接口不支持调整
BANDWIDTH_POSTPAID_BY_MONTH计费方式的带宽。接口不支持批量调整
BANDWIDTH_PREPAID 和 BANDWIDTH_POSTPAID_BY_HOUR 计费方式的带宽。接口不支持批量调整混合计费方式的带宽。例如不支持同时调整
TRAFFIC_POSTPAID_BY_HOUR和BANDWIDTH_PACKAGE计费方式的带宽。2. 输入参数
参数名称 | 类型 | 是否必选 | 描述 |
Version | String | 是 | 表示 API 版本号，主要用于标识请求的不同 API 版本。 本接口第一版本可传：2017-03-12。 |
InstanceIds.N | array of Strings | 是 | |
InternetAccessible | 是 | 公网出带宽配置。不同机型带宽上限范围不一致，具体限制详见带宽限制对账表。暂时只支持 InternetMaxBandwidthOut参数。 | |
StartTime | String | 否 | 带宽生效的起始时间。格式： YYYY-MM-DD，例如：2016-10-30。起始时间不能早于当前时间。如果起始时间是今天则新设置的带宽立即生效。该参数只对包年包月带宽有效，其他模式带宽不支持该参数，否则接口会以相应错误码返回。 |
EndTime | String | 否 | 带宽生效的终止时间。格式： YYYY-MM-DD，例如：2016-10-30。新设置的带宽的有效期包含终止时间此日期。终止时间不能晚于包年包月实例的到期时间。实例的到期时间可通过 DescribeInstances 接口返回值中的ExpiredTime获取。该参数只对包年包月带宽有效，其他模式带宽不支持该参数，否则接口会以相应错误码返回。 |
3. 输出参数
参数名称 | 类型 | 描述 |
Price | Price object | 该参数表示带宽调整为对应大小之后的价格。 |
RequestId | String | 唯一请求 ID。每次请求都会返回一个唯一的 requestId，当客户调用接口失败找后台研发人员处理时需提供该 requestId 具体值。 |
4. 错误码
错误码 | 描述 |
MissingParameter | 参数缺失。请求没有带必选参数。 |
InvalidInstanceId.NotFound | 无效实例 ID。指定的实例ID不存在。 |
InvalidInstanceId.Malformed | 无效实例 ID。指定的实例ID格式错误。例如ID长度错误ins-1122。 |
InvalidParameter | 无效参数。参数不合要求或者参数不被支持等。 |
InvalidParameterValue | 无效参数值。参数值格式错误或者参数值不被支持等。 |
InvalidParameterValue.Range | 无效参数值。参数值取值范围不合法。 |
InvalidInstance.NotSupported | 实例不支持该操作。 |
InvalidPermission | 账户不支持该操作。 |
InvalidAccount.InsufficientBalance | 账户余额不足。 |
InvalidAccount.UnpaidOrder | 账户有未支付订单。 |
InternalServerError | 内部服务错误。 |
5. 示例
示例1
包年包月实例调整带宽上限：
请求参数
https://cvm.api.qcloud.com/v2/index.php?Action=InquiryPriceResetInstancesInternetMaxBandwidth&Version=2017-03-12&InstanceIds.1=ins-2zvpghhc&InternetAccessible.InternetMaxBandwidthOut=20&StartTime=2017-05-15&EndTime=2017-05-16
返回参数
{"Response": {"Price": {"BandwidthPrice": {"OriginalPrice": "96.33","DiscountPrice": "96.33"}},"RequestId": "d4603747-86b9-4108-b42f-f623e7cc2538"}}
示例2
按量付费实例调整带宽上限：
请求参数
https://cvm.api.qcloud.com/v2/index.php?Action=InquiryPriceResetInstancesInternetMaxBandwidth&InstanceIds.1=ins-fd8spnmqInternetAccessible.InternetMaxBandwidthOut=20&DryRun=FALSE
返回参数
{"Response": {"Price": {"BandwidthPrice": {"UnitPrice": 0.8,"ChargeUnit": "GB"}},"RequestId": "700864b9-85da-4cb9-bc80-d99eaf9fa047"}}
