调整实例带宽上限

最近更新时间: 2024-06-18 14:31:29

1. 接口描述

接口请求域名: cvm.api3.fincloud.tencent.cn。

本接口 (ResetInstancesInternetMaxBandwidth) 用于调整实例公网带宽上限。

  • 不同机型带宽上限范围不一致。
  • 对于 BANDWIDTH_PREPAID 计费方式的带宽,需要输入参数 StartTimeEndTime ,指定调整后的带宽的生效时间段。在这种场景下目前不支持调小带宽,会涉及扣费,请确保账户余额充足。
  • 对于 TRAFFIC_POSTPAID_BY_HOURBANDWIDTH_POSTPAID_BY_HOURBANDWIDTH_PACKAGE 计费方式的带宽,使用该接口调整带宽上限是实时生效的,可以在带宽允许的范围内调大或者调小带宽,不支持输入参数 StartTimeEndTime
  • 接口不支持调整 BANDWIDTH_POSTPAID_BY_MONTH 计费方式的带宽。
  • 接口不支持批量调整 BANDWIDTH_PREPAIDBANDWIDTH_POSTPAID_BY_HOUR 计费方式的带宽。
  • 接口不支持批量调整混合计费方式的带宽。例如不支持同时调整 TRAFFIC_POSTPAID_BY_HOURBANDWIDTH_PACKAGE 计费方式的带宽。

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

接口更新时间:2022-10-27 11:43:18。

接口只验签名不鉴权。

2. 输入参数

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

参数名称 必选 允许NULL 类型 描述
Action String 公共参数,本接口取值:ResetInstancesInternetMaxBandwidth
Version String 公共参数,本接口取值:2017-03-12
Region String 公共参数,详见产品支持的地域列表(TODO)
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获取。该参数只对包年包月带宽有效,其他模式带宽不支持该参数,否则接口会以相应错误码返回。

3. 输出参数

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

4. 错误码

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

错误码 描述
InvalidInstanceId.NotFound
InvalidInstance.NotSupported
InvalidParameterValue
InternalServerError
InvalidParameterValue.Range
InvalidAccount.InsufficientBalance
InvalidInstanceId.Malformed
InvalidParameter
MissingParameter
InvalidAccount.UnpaidOrder
InvalidPermission