使用ReplaceBandwidthPackage為Global Acceleration執行個體替換頻寬包-Global Acceleration-阿里雲

介面說明

在調用本介面時，請注意以下事項：

替換頻寬包不會中斷Global Acceleration的轉寄流量。
ReplaceBandwidthPackage 介面屬於非同步介面，即系統會先返回一個請求 ID，但頻寬包並未替換完成，系統背景替換任務仍在進行。您可以調用 DescribeAccelerator 或 ListAccelerators 查詢Global Acceleration執行個體的狀態：
- 當Global Acceleration執行個體處於 configuring 狀態時，表示頻寬包正在替換中，在該狀態下，您只能執行查詢操作，不能執行其他動作。
- 當Global Acceleration執行個體處於 active 狀態時，表示頻寬包替換完成。
ReplaceBandwidthPackage 介面不支援並發替換同一個Global Acceleration執行個體的頻寬包。

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ga:ReplaceBandwidthPackage

update

*BandwidthPackage

acs:ga:{#regionId}:{#accountId}:bandwidthpackage/{#bandwidthPackageId}

無

名稱	類型	必填	描述	樣本值
RegionId	string	是	Global Acceleration執行個體所在的地區，僅取值cn-hangzhou。	cn-hangzhou
BandwidthPackageId	string	是	要替換的新的頻寬包 ID。指定頻寬包時，請注意：僅支援指定未綁定任何Global Acceleration執行個體的頻寬包。如果要替換的頻寬包為基礎頻寬包，請確保要替換的新的基礎頻寬包的頻寬必須大於或等於加速地區中已指派的頻寬總額。	gbwp-bp176neb61yhcymow****
TargetBandwidthPackageId	string	是	要被替換的舊的頻寬包 ID。	gbwp-o978hgeb61yhcymow****
AcceleratorId	string	否	待替換頻寬包的Global Acceleration執行個體 ID。	ga-bp17frjjh0udz4qz****

正常返回樣本

JSON格式

{
  "RequestId": "A0EA8CCA-F081-4338-9790-A1C791CCA779"
}

HTTP status code	錯誤碼	錯誤資訊	描述
400	NotExist.BandwidthPackage	The bandwidth package does not exist.	頻寬包不存在
400	StateError.BandwidthPackage	The state of bandwidth package is invalid.	頻寬包狀態非法
400	NotExist.BasicBandwidthPackage	You must specify the basic bandwidth package.	缺少基礎頻寬包

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

更多資訊，參考變更詳情。