すべてのプロダクト
Search

このプロダクト

    :CreateCenBandwidthPackage

    ドキュメントセンター

    :CreateCenBandwidthPackage

    最終更新日:Nov 12, 2024

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

    使用上の注意

    • 帯域幅プランを作成するときに、接続するエリアを指定する必要があります。 エリアには、1つ以上のAlibaba Cloudリージョンが含まれます。 帯域幅プランのエリアを選択するときは、エリアに接続するリージョンが含まれていることを確認します。 サポートされているエリアとリージョンの詳細については、「帯域幅プランの購入」をご参照ください。

    • 課金ルールの詳細については、「課金」をご参照ください。

    • CreateCenBandwidthPackageは非同期操作です。 リクエストを送信すると、システムは帯域幅プランIDを返しますが、操作はシステムのバックグラウンドでまだ実行されています。 DescribeCenBandwidthPackagesを呼び出して、帯域幅プランのステータスを照会できます。 帯域幅プランがIdleまたはInUse状態の場合、帯域幅プランが作成されます。

    デバッグ

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

    リクエストパラメーター

    パラメーター

    タイプ

    必須

    例

    説明

    Action

    String

    必須

    CreateCenBandwidthPackage

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

    ClientToken

    String

    任意

    02fb3da4-130e-11e9-8e44-001****

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

    クライアントを使用してトークンを生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。

    名前

    String

    任意

    nametest

    帯域幅プランの名前。

    名前は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 名前は文字で始める必要があり、http:// またはhttps:// で始めることはできません。

    説明

    String

    任意

    namedesc

    帯域幅プランの説明。

    帯域幅

    Integer

    必須

    2

    帯域幅プランの最大帯域幅値。 単位は、Mbit/s です。 有効な値: 2〜10000。

    GeographicRegionAId

    String

    必須

    China

    ネットワークインスタンスがデプロイされているエリア。 有効な値：

    • 中国: 中国本土

    • 北アメリカ: 北アメリカ

    • アジア太平洋: アジア太平洋

    • ヨーロッパ: ヨーロッパ

    • オーストラリア (サービス終了): オーストラリア (サービス終了)

    GeographicRegionBId

    String

    必須

    China

    他のネットワークインスタンスがデプロイされているエリア。 有効な値: 有効な値:

    • 中国: 中国本土

    • 北アメリカ: 北アメリカ

    • アジア太平洋: アジア太平洋

    • ヨーロッパ: ヨーロッパ

    • オーストラリア (サービス終了): オーストラリア (サービス終了)

    BandwidthPackageChargeType

    String

    任意

    PREPAY

    帯域幅プランの課金方法。 有効な値: PREPAY。課金方法が従量課金であることを示します。

    期間

    Integer

    選択可能

    1

    帯域幅プランのサブスクリプション期間。 デフォルト値は 1 です。

    • PricingCycleがMonthに設定されている場合、Periodを1〜3 6の値に設定します。

    • PricingCycleがYearに設定されている場合、Periodを1〜3の値に設定します。

    説明

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

    PricingCycle

    String

    任意

    1 か月

    帯域幅プランの課金サイクル。 有効な値：

    • Month (デフォルト): 月単位で課金されます。

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

    AutoPay

    ブール値

    選択可能

    false

    帯域幅プランの支払いを自動的に完了するかどうかを指定します。 有効な値：

    • true: はい

    • false (デフォルト): いいえ

    パラメーターをfalseに設定した場合、この操作を呼び出した後、課金管理に移動して支払いを完了します。 インスタンスは、支払いが完了した後にのみ作成されます。

    レスポンスパラメーター

    パラメーター

    タイプ

    例

    説明

    CenBandwidthPackageId

    String

    cenbwp-4c2zaavbvh5fx ****

    帯域幅プランの ID 。

    CenBandwidthPackageOrderId

    String

    20156420004 ****

    帯域幅プランの注文のID。

    RequestId

    String

    E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B

    リクエストの ID。

    例

    リクエストの例

    http(s)://[Endpoint]/?Action=CreateCenBandwidthPackage
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&Name=nametest
&Description=namedesc
&Bandwidth=2
&GeographicRegionAId=China 
&GeographicRegionBId=China 
&BandwidthPackageChargeType=PREPAY
&Period=1
&PricingCycle=Month
&AutoPay=false
&AutoRenew=false
&Common request parameters

    成功レスポンスの例

    XML 形式

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

<CreateCenBandwidthPackageResponse>
    <RequestId>E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B</RequestId>
    <CenBandwidthPackageOrderId>20156420004****</CenBandwidthPackageOrderId>
    <CenBandwidthPackageId> cenbwp-4c2zaavbvh5fx****</CenBandwidthPackageId>
</CreateCenBandwidthPackageResponse>

    JSON 形式

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

{
  "RequestId" : "E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B",
  "CenBandwidthPackageOrderId" : "20156420004****",
  "CenBandwidthPackageId" : "cenbwp-4c2zaavbvh5fx****"
}

    エラーコード

    HttpCode

    エラーコード

    エラーメッセージ

    説明

    400

    UnSupported.ChargeType

    料金タイプはサポートされていません。

    指定された課金方法がサポートされていない場合に表示されるエラーメッセージ。

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