調用TempUpgradeCenBandwidthPackageSpec接口對云企業網預付費帶寬包實例臨時升配。
接口說明
預付費帶寬包支持臨時升配功能。通過臨時升配功能，您可以在指定時間內提高帶寬包的帶寬值，靈活應對業務帶寬波動。
臨時升配支持的最短升級間隔為 3 小時，支付完成后帶寬立刻升級成功，升級過程不中斷業務。
說明
預付費帶寬包實例在臨時升配到期后恢復到原有帶寬峰值時，如果實例上的業務流量超過了原有帶寬峰值的限制，那么業務流量可能會因限速而被丟棄，請合理規劃臨時升配的到期時間，并確保帶寬峰值和業務需求匹配。
- 目前，臨時升配功能默認不開放。如需使用，請聯系客戶經理申請。
- 后付費帶寬包和已到期的預付費帶寬包不支持臨時升配功能。
- TempUpgradeCenBandwidthPackageSpec 接口屬于異步接口，即系統會先返回一個 RequestId，但帶寬包并未升配完成，系統后臺的升配任務仍在進行。您可以調用 DescribeCenBandwidthPackages 接口查詢帶寬包的規格。當帶寬包的規格符合預期，表示帶寬包升配完成。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀?。≧ead）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| cen:TempUpgradeCenBandwidthPackageSpec | update |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| 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 | InvalidParameter | Invalid parameter. | 參數不合法。 |
| 400 | Unauthorized | The AccessKeyId is unauthorized. | 賬號無權限操作。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史