帯域幅プランを変更します。

説明　

この操作を呼び出すときは、次の項目に注意してください。

  • UpdateBandwidthPackageは、帯域幅プランの帯域幅値を除く設定を変更するために呼び出されたときの同期操作です。 新しい設定は、操作が実行された直後に有効になります。
  • UpdateBandwidthPackageは、Global Accelerator (GA) インスタンスに関連付けられていない帯域幅プランの帯域幅値を含む設定を変更するために呼び出された場合の非同期操作です。 リクエストを送信した後、システムはリクエストIDを返しますが、操作はシステムバックグラウンドで実行中です。 DescribeBandwidthPackageを呼び出して、帯域幅プランが変更されているかどうかを照会できます。
    • 帯域幅プランのパラメーター設定が変更されていない場合は、帯域幅プランが変更中であることを示します。 この場合、クエリ操作のみを実行できます。
    • 帯域幅プランのパラメーター設定が変更された場合は、帯域幅プランが変更されたことを示します。
  • UpdateBandwidthPackageは、GAインスタンスに関連付けられている帯域幅プランの帯域幅値を含む設定を変更するために呼び出された場合の非同期操作です。 リクエストを送信した後、システムはリクエストIDを返しますが、操作はシステムバックグラウンドで実行中です。 DescribeAcceleratorを呼び出して、GAインスタンスの状態を照会し、関連付けられている帯域幅プランが変更されているかどうかを判断できます。
    • GAインスタンスが設定中の状態の場合、帯域幅プランが変更中であることを示します。 この場合、クエリ操作のみを実行できます。
    • GAインスタンスがアクティブ状態の場合、帯域幅プランが変更されていることを示します。
  • UpdateBandwidthPackage操作は、特定の期間内に同じ帯域幅プランに対して繰り返し呼び出すことはできません。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 UpdateBandwidthPackage

実行する操作です。 値をUpdateBandwidthPackageに設定します。

RegionId String 必須 cn-hangzhou

GAインスタンスがデプロイされているリージョンのID。 値をcn-hangzhouに設定します。

BandwidthPackageId String 必須 gbwp-bp1sgzldyj6b4q7cx****

変更する帯域幅プランのID。

名前 String 任意 testName

帯域幅プランの名前。

名前は2 ~ 128文字で、英数字、ピリオド (.) 、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は英字とする必要があります。

説明　 String 任意 testDescription

帯域幅プランの説明。

説明の長さは最大256文字です。

帯域幅 Integer × 2

帯域幅プランの帯域幅の値。 単位：Mbit/秒。

有効な値: 2〜2000。

BandwidthType String 任意 基本

帯域幅のタイプ。 有効な値：

  • 基本: 基本
  • Enhanced: enhanced
  • Advanced: プレミアム
説明 [基本] 帯域幅を [拡張] 帯域幅にのみアップグレードできます。 拡張帯域幅または拡張帯域幅を別のタイプに変更することはできません。
AutoPay Boolean いいえ false

自動支払いを有効にするかどうかを指定します。 デフォルト値：false 有効な値：

  • false: 自動支払いを無効にします。 このオプションを選択した場合、注文が生成された後、注文センターに移動して支払いを完了する必要があります。
  • true: 自動支払いを有効にします。 支払いは自動的に完了します。
AutoUseCoupon Boolean いいえ false

クーポンを使用するかどうかを指定します。 デフォルト値：false 有効な値：

  • true: クーポンを使用します。
  • false: クーポンを使用しません。

レスポンスパラメーター

項目 データ型 例: 説明　
BandwidthPackage String gbwp-bp1eo4f57z1kbbcmn****

帯域幅プランの ID。

説明　 String testDescription

帯域幅プランの説明。

RequestId String 1DF3A3CB-B621-44F8-9870-C20D034D7AB

リクエストの ID です。

名前 String testName

帯域幅プランの名前。

例

リクエストの例

http(s)://[Endpoint]/?Action=UpdateBandwidthPackage
&RegionId=cn-hangzhou
&BandwidthPackageId=gbwp-bp1sgzldyj6b4q7cx ****
&名前=testName
&Description=testDescription
&帯域幅=2
&BandwidthType=基本
&AutoPay=false
&AutoUseCoupon=false
&共通リクエストパラメータ

正常に処理された場合のレスポンス例

XML 形式 

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateBandwidthPackageResponse>
    <BandwidthPackage>gbwp-bp1eo4f57z1kbbcmn****</BandwidthPackage>
    <Description>testDescription</Description>
    <RequestId>1DF3A3CB-B621-44F8-9870-C20D034D7AB</RequestId>
    <名前> testName</Name>
</UpdateBandwidthPackageResponse>

JSON 形式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "BandwidthPackage" : "gbwp-bp1eo4f57z1kbbcmn ****" 、
  "Description" : "testDescription" 、
  "RequestId" : "1DF3A3CB-B621-44F8-9870-C20D034D7AB" 、
  "Name" : "testName"
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明　
400 StateError.BandwidthPackage 帯域幅パッケージの状態が無効です。 指定された帯域幅プランの状態が無効な場合に返されるエラーメッセージ。
400 NotExist.BandwidthPackage 帯域幅パッケージが存在しません。 指定された帯域幅プランが存在しない場合に返されるエラーメッセージ。
400 UpgradeError.BandwidthPackage 帯域幅パッケージの設定は、すべてのアップグレードまたはすべてのダウングレードである必要があります。 帯域幅プランを同時にアップグレードおよびダウングレードできない場合に返されるエラーメッセージ。 帯域幅プランのアップグレードまたはダウングレードのみが可能です。

エラーコードリストについては、「API エラーセンター」をご参照ください。