调用TempUpgradeCenBandwidthPackageSpec进行云企业网预付费带宽包临时升配

接口说明

预付费带宽包支持临时升配功能。通过临时升配功能，您可以在指定时间内提高带宽包的带宽值，灵活应对业务带宽波动。

临时升配支持的最短升级间隔为 3 小时，支付完成后带宽立刻升级成功，升级过程不中断业务。

说明

预付费带宽包实例在临时升配到期后恢复到原有带宽峰值时，如果实例上的业务流量超过了原有带宽峰值的限制，那么业务流量可能会因限速而被丢弃，请合理规划临时升配的到期时间，并确保带宽峰值和业务需求匹配。

目前，临时升配功能默认不开放。如需使用，请联系客户经理申请。
后付费带宽包和已到期的预付费带宽包不支持临时升配功能。
TempUpgradeCenBandwidthPackageSpec 接口属于异步接口，即系统会先返回一个 RequestId，但带宽包并未升配完成，系统后台的升配任务仍在进行。您可以调用 DescribeCenBandwidthPackages 接口查询带宽包的规格。当带宽包的规格符合预期，表示带宽包升配完成。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

cen:TempUpgradeCenBandwidthPackageSpec

update

*CenBandwidthPackage

acs:cen:*:{#accountId}:cenbandwidthpackage/{#cenbandwidthpackageId}

无

名称	类型	必填	描述	示例值
CenBandwidthPackageId	string	是	带宽包实例 ID。	cenbwp-y08yosedeqlpua****
Bandwidth	integer	是	临时提升的带宽峰值。单位：Mbps。取值范围：2~10000。	20
EndTime	string	是	临时提升带宽的到期时间。时间按照 ISO8601 标准表示，并使用 UTC 时间。格式为：YYYY-MM-DDThh:mm:ssZ。	2022-07-24T13:00:52Z

正常返回示例

JSON格式

{
  "RequestId": "DB0A026C-A8E5-40AB-977E-3A87DD78F694"
}

HTTP status code	错误码	错误信息	描述
400	Forbidden.AssociatedUnsupportedInterRegionTrafficQosPolicy	The transit router associated with the bandwidth plan has an inter-region traffic scheduling policy that allocates bandwidth based on absolute values. You must delete this policy before you can change the configurations.	检测到您的带宽包关联的TR配置了带宽保障类型为按带宽绝对值模式的跨地域流量调度策略，需要先删除该策略，再进行变配操作。
400	InvalidOperation.OrderParameterIllegal	The order parameters are abnormal, please check whether the order parameters are correct and whether they conflict with existing orders.	下单参数异常，请检查下单参数是否正确以及是否与已有订单冲突等。
400	InvalidParameter	Invalid parameter.	参数不合法。
400	Unauthorized	The AccessKeyId is unauthorized.	账号无权限操作。
400	InvalidOperation.UpgradeBwpBandwidth	The operation is invalid because the upgrade is equal or less than the original bandwidth.	操作非法，带宽包升级的带宽值非法

访问错误中心查看更多错误码。

更多信息，参考变更详情。