API文档中心

不同机型带宽上限范围不一致。
对于 BANDWIDTH_PREPAID 计费方式的带宽，需要输入参数 StartTime 和 EndTime ，指定调整后的带宽的生效时间段。在这种场景下目前不支持调小带宽，会涉及扣费，请确保账户余额充足。
对于 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 计费方式的带宽。

默认接口请求频率限制：10次/秒。

接口更新时间：2023-07-19 10:40:59。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：ResetInstancesInternetMaxBandwidth
Version	是	否	String	公共参数，本接口取值：2017-03-12
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
InstanceIds	是	否	Array of String	一个或多个待操作的实例ID。可通过DescribeInstances接口返回值中的 `InstanceId` 获取。每次请求批量实例的上限为100。
InternetAccessible	是	否	InternetAccessible	公网出带宽配置。不同机型带宽上限范围不一致，具体限制详见带宽限制对账表。暂时只支持 `InternetMaxBandwidthOut` 参数。
StartTime	否	否	String	带宽生效的起始时间。格式：`YYYY-MM-DD`，例如：`2016-10-30`。起始时间不能早于当前时间。如果起始时间是今天则新设置的带宽立即生效。该参数只对包年包月带宽有效，其他模式带宽不支持该参数，否则接口会以相应错误码返回。
EndTime	否	否	String	带宽生效的终止时间。格式： `YYYY-MM-DD` ，例如：`2016-10-30` 。新设置的带宽的有效期包含终止时间此日期。终止时间不能晚于包年包月实例的到期时间。实例的到期时间可通过 DescribeInstances接口返回值中的`ExpiredTime`获取。该参数只对包年包月带宽有效，其他模式带宽不支持该参数，否则接口会以相应错误码返回。

参数名称	类型	描述
TaskId	String	此参数对外不可见。任务Id
FlowId	Int64	此参数对外不可见。任务流转Id
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InvalidInstanceId.NotFound	没有找到相应实例。
InvalidInstance.NotSupported	不被支持的实例。
InvalidParameterValue	无效参数值。参数值格式错误或者参数值不被支持等。
InternalServerError	操作内部错误。
InvalidParameterValue.Range	无效参数值。参数值取值范围不合法。
InvalidAccount.InsufficientBalance	账户余额不足。
InvalidInstanceId.Malformed	无效实例`ID`。指定的实例`ID`格式错误。例如实例`ID`长度错误`ins-1122`。
InvalidParameter	无效参数。参数不合要求或者参数不被支持等。
MissingParameter	参数缺失。请求没有带必选参数。
InvalidAccount.UnpaidOrder	账户有未支付订单。
InvalidPermission	账户不支持该操作。