帯域幅プランを作成します。

説明　

アクセラレーションにGlobal Accelerator (GA) を使用するには、基本帯域幅プランを購入する必要があります。 基本帯域幅プランは、次の帯域幅タイプをサポートします。

  • 基本: デフォルトのアクセラレーションリージョンとデフォルトのサービスリージョンはどちらも中国本土にあります。 高速化サービスはAlibaba Cloudにデプロイされています。
  • 拡張: デフォルトのアクセラレーションリージョンとデフォルトのサービスリージョンの両方が中国本土にあります。 高速化サービスは、Alibaba Cloudの内外でデプロイできます。
  • プレミアム: デフォルトのアクセラレーションリージョンとデフォルトのサービスリージョンはどちらも中国本土にあります。 高速化サービスは、Alibaba Cloudの内外でデプロイできます。 中国本土のクライアントのデータ転送を高速化する場合は、高速化リージョンとして中国 (香港) を選択する必要があります。

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

  • CreateBandwidthPackageは非同期操作です。 リクエストを送信すると、システムは帯域幅プランのIDを返しますが、帯域幅プランはシステムのバックグラウンドでまだ作成されています。 DescribeBandwidthPackageを呼び出して、帯域幅プランの状態を照会できます。
    • 帯域幅プランがinit状態の場合、帯域幅プランが作成中であることを示します。 この場合、クエリ操作のみを実行できます。
    • 帯域幅プランがアクティブ状態の場合、帯域幅プランが作成されていることを示します。
  • CreateBandwidthPackage操作は、特定の期間内に同じGAインスタンスに対して繰り返し呼び出すことはできません。

デバッグ

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

リクエストパラメーター

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

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

RegionId String 必須 cn-hangzhou

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

帯域幅 Integer 〇 2

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

有効な値: 2〜2000。

有効期間 String いいえ 1

サブスクリプション期間です。

  • PricingCycleパラメーターがMonthに設定されている場合、Durationパラメーターの有効な値は9に1されます。
  • PricingCycleパラメーターがYearに設定されている場合、Durationパラメーターの有効な値は3に1されます。

ChargeTypeがPREPAYに設定されている場合、このパラメーターは必須です。

PricingCycle String 任意 月

課金サイクル。 有効な値：

  • Month: 毎月請求されます。
  • 年: 毎年請求されます。

ChargeTypeがPREPAYに設定されている場合、このパラメーターは必須です。

AutoPay Boolean いいえ false

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

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

リクエストのべき等性を保証するために使用されるクライアントトークン。

クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientTokenにはASCII文字のみを含めることができます。

説明 このパラメーターを設定しない場合、ClientTokenはRequestIdの値に設定されます。 RequestIdの値は、APIリクエストごとに異なる場合があります。
種類 String 必須 基本

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

  • Basic: 基本帯域幅プラン
  • CrossDomain: クロスリージョン高速化帯域幅プラン

Alibaba Cloud Chinaサイトでこの操作を呼び出すと、Basicのみがサポートされます。

BandwidthType String 任意 基本

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

  • 基本: 基本
  • Enhanced: enhanced
  • Advanced: プレミアム

TypeがBasicに設定されている場合、このパラメーターは必須です。

AutoUseCoupon String 任意 false

クーポンを使用して自動的に請求書を支払うかどうかを指定します。 デフォルト値：false 有効な値：

  • true: はい
  • false: いいえ
説明 このパラメーターは、AutoPayがtrueに設定されている場合にのみ必要です。
比率 Integer いいえ 30

pay-by-95th-percentile-bandwidthメーター方式が使用されている場合に保証される最小帯域幅の割合。 有効な値: 30〜100。

説明 このパラメーターは、BillingTypeがPayBY95に設定されている場合にのみ必要です。
BillingType String 任意 トラフィック課金

従量課金の課金方法を使用する場合に使用される課金方法。 デフォルト値：PayByTraffic。 有効な値：

  • PayByTraffic: データ転送による支払い
  • PayBY95: pay-by-95th-percentile

pay-by-95th-percentile計測方法は、ホワイトリストに追加されたユーザーのみが使用できます。 この機能を使用するには、チケットを起票してください。

ChargeType String 任意 PREPAY

帯域幅プランの課金方法。 デフォルト値: PREPAY。 有効な値：

  • PREPAY: サブスクリプション
  • POSTPAY: 従量課金

従量課金方法は、ホワイトリストに追加されたユーザーのみが利用できます。 この機能を使用するには、チケットを起票してください。

CbnGeographicRegionIdA String 任意 China-mainland

接続するエリアA。 値をChina-mainlandに設定します。

このパラメーターは、Alibaba Cloud Internationalサイトでこの操作を呼び出す場合にのみ設定できます。

CbnGeographicRegionIdB String 任意 グローバル

接続するエリアB。 値をGlobalに設定します。

このパラメーターは、Alibaba Cloud Internationalサイトでこの操作を呼び出す場合にのみ設定できます。

AutoRenew Boolean いいえ false

帯域幅プランの自動更新を有効にするかどうかを指定します。 デフォルト値：false 有効な値：

  • true: 自動更新を有効にします。
  • falseは自動更新を無効にします。
AutoRenewDuration Integer いいえ 1

自動更新期間。 単位：月。

有効な値: 1〜12。 デフォルト値: 1

説明 このパラメーターは、AutoRenewがtrueに設定されている場合にのみ必要です。

レスポンスパラメーター

項目 データ型 例: 説明　
RequestId String 4B6DBBB0-2D01-4C6A-A384-4129266E6B78

リクエストの ID です。

BandwidthPackageId String gbwp-bp1sgzldyj6b4q7cx****

帯域幅プランの ID 。

OrderId String 208257 ****

注文 ID。

請求書が自動的に支払われない場合は、注文センターに行って支払いを完了する必要があります。

例

リクエストの例

http(s)://[Endpoint]/?Action=CreateBandwidthPackage
&RegionId=cn-hangzhou
&帯域幅=2
&期間=1
&PricingCycle=月
&AutoPay=false
&ClientToken=123e4567 ****
&タイプ=基本
&BandwidthType=基本
&AutoUseCoupon=false
&比率=30
&BillingType=PayByTraffic
&ChargeType=PREPAY
&CbnGeographicRegionIdA=中国-本土
&CbnGeographicRegionIdB=グローバル
&AutoRenew=false
&AutoRenewDuration=1
&<共通リクエストパラメーター>

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

XML 形式 

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

<CreateBandwidthPackageResponse>
    <RequestId>4B6DBBB0-2D01-4C6A-A384-4129266E6B78</RequestId>
    <BandwidthPackageId>gbwp-bp1sgzldyj6b4q7cx****</BandwidthPackageId>
    <OrderId>208257 ****</OrderId>
</CreateBandwidthPackageResponse>

JSON 形式 

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

{
  "RequestId" : "4B6DBBB0-2D01-4C6A-A384-4129266E6B78" 、
  "BandwidthPackageId" : "gbwp-bp1sgzldyj6b4q7cx ****" 、
  "OrderId" : "208257 ****"
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明　
400 MissingParameter.BandwidthType BandwidthTypeを指定する必要があります。 BandwidthTypeが設定されていない場合に返されるエラーメッセージ。

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