全部產品
Search
文件中心

Cloud Enterprise Network:TempUpgradeCenBandwidthPackageSpec - 進行雲企業網預付費頻寬包臨時升配

更新時間:Dec 14, 2025

調用TempUpgradeCenBandwidthPackageSpec介面對雲企業網預付費頻寬包執行個體臨時升配。

介面說明

預付費頻寬包支援臨時升配功能。通過臨時升配功能,您可以在指定時間內提高頻寬包的頻寬值,靈活應對業務頻寬波動。

臨時升配支援的最短升級間隔為 3 小時,支付完成後頻寬立刻升級成功,升級過程不中斷業務。

說明

預付費頻寬包執行個體在臨時升配到期後恢複到原有頻寬峰值時,如果執行個體上的業務流量超過了原有頻寬峰值的限制,那麼業務流量可能會因限速而被丟棄,請合理規劃臨時升配的到期時間,並確保頻寬峰值和業務需求匹配。

  • 目前,臨時升配功能預設不開放。如需使用,請聯絡客戶經理申請。

  • 後付費頻寬包和已到期的預付費頻寬包不支援臨時升配功能。

  • TempUpgradeCenBandwidthPackageSpec 介面屬於非同步介面,即系統會先返回一個 RequestId,但頻寬包並未升配完成,系統背景升配任務仍在進行。您可以調用 DescribeCenBandwidthPackages 介面查詢頻寬包的規格。當頻寬包的規格符合預期,表示頻寬包升配完成。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

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

返回參數

名稱

類型

描述

樣本值

object

返回結果。

RequestId

string

請求 ID。

DB0A026C-A8E5-40AB-977E-3A87DD78F694

樣本

正常返回樣本

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. 操作非法,頻寬包升級的頻寬值非法

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情