すべてのプロダクト
Search
ドキュメントセンター

Anti-DDoS:APIを呼び出してAnti-DDoS Proxyインスタンスを作成する

最終更新日:May 30, 2024

Anti-DDoS Proxy (中国本土) およびAnti-DDoS Proxy (中国本土外) は、インスタンスを作成するためのAPI操作を提供しません。 インスタンスを作成するには、トランザクションおよび請求書管理API (略してBSS APIとも呼ばれます) によって提供されるCreateInstance操作を呼び出すことができます。 このトピックでは、BSS APIを呼び出してインスタンスを作成する方法について説明します。

背景情報

BSS APIは、Alibaba Cloudリソースの管理に使用される一連の一般的な操作です。 たとえば、サービス料金の照会、インスタンスの管理、請求書の取得などの操作を呼び出すことができます。 BSS APIの操作の詳細については、「APIの概要」をご参照ください。

BSS APIによって提供されるCreateInstance操作を呼び出して、インスタンスを作成できます。 操作を呼び出す方法の詳細については、「RPC APIのリクエスト構文と署名メソッドV2」をご参照ください。

使用上の注意

  • CreateInstance操作を呼び出してインスタンスを作成すると、インスタンスの料金がアカウントの残高から自動的に差し引かれます。 課金の詳細については、「課金」をご参照ください。

  • 国際サイト (alibabacloud.com) で作成されたアカウントを使用してインスタンスを作成する場合は、そのアカウントに信用管理IDを適用する必要があります。 アカウントの信用管理IDを申請しない場合は、アカウントマネージャーに連絡して信用管理IDを申請してください。

Anti-DDoSプロキシ (中国本土) インスタンスの作成

CreateInstance操作を呼び出してAnti-DDoS Proxy (中国本土) インスタンスを作成する場合、次の表に基づいてリクエストパラメーターを設定する必要があります。

説明

共通リクエストパラメーターの詳細については、「RPC APIのリクエスト構文と署名メソッドV2」をご参照ください。

表 1 Anti-DDoSプロキシ (中国本土) インスタンスの作成に使用されるリクエストパラメーター

パラメーター

データ型

必須

説明

Action

String

必須

CreateInstance

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

ProductCode

String

必須

ddos

インスタンスのサービスコード。

値をddosに設定します。これは、Anti-DDoS Proxyを指定します。

ProductType

String

必須

ddoscoo

インスタンスのサービスタイプ。

有効な値:

  • ddoscoo。中国サイト (aliyun.com) のAnti-DDoS Proxy (中国本土) を指定します。

  • ddosco_intlは、国際サイト (alibabacloud.com) のAnti-DDoS Proxy (中国本土) を指定します。

SubscriptionType

String

必須

サブスクリプション

インスタンスの課金方法です。

値をサブスクリプションに設定します。これは、サブスクリプションの課金方法を示します。

Period

Integer

1

インスタンスのサブスクリプション期間。 単位:月。

有効な値: 1234561224

パラメータ。N. コード

String

必須

FunctionVersion

Parameter.N.Codeパラメーターは、インスタンスの設定項目Nを指定します。 Parameter.N.Valueパラメーターは、設定項目Nの値を指定します。

Parameter.N.CodeParameter.N.Valueのペアを指定して、アイテムを設定できます。 Nは、構成アイテムのシリアル番号を指定します。 たとえば、Parameter.1.CodeとParameter.1.Valueのペアは、最初の設定項目とその値を指定します。

詳細については、「Anti-DDoS Proxy (中国本土) インスタンスの設定」をご参照ください。

パラメータ. N. 値

String

必須

0

RenewalStatus

String

任意

ManualRenewal

インスタンスの更新に使用されるメソッド。 有効な値:

  • ManualRenewal (デフォルト)

  • 自動更新

更新期間

Integer

いいえ

1

インスタンスの自動更新期間。 単位:月。

説明

RenewalStatusAutoRenewalに設定した場合、このパラメーターを指定する必要があります。

ClientToken

String

任意

123e4567-e89b-12d3-a456-42665544 ****

リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。 詳細については、「」をご参照ください。べき等性を確保するにはどうすればよいですか?

説明

このパラメーターを指定しない場合、システムは自動的にリクエストIDをクライアントトークンとして使用します。

Anti-DDoS Proxy (中国本土) インスタンスを作成する場合、次の表に基づいて設定を完了するには、Parameter.N.CodeParameter.N.Valueのペアを指定する必要があります。

表 2. Anti-DDoSプロキシ (中国本土) インスタンスの設定

設定項目 (コード)

データ型

例 (値)

説明

エディション

String

小屋

インスタンスの軽減プラン。 値をcoopに設定します。これは、職業軽減計画を示します。

FunctionVersion

String

0

インスタンスの関数プラン。 有効な値:

  • 0: 標準関数プラン

  • 1: 拡張関数プラン

NormalQps

浮く

3000

インスタンスによって提供される1秒あたりのクリーンクエリ (QPS) 。

有効な値: 3000〜100000。 値は100の倍数でなければなりません。

PortCount

浮く

50

保護するポートの数。

有効な値: 50 ~ 400 値は5の倍数でなければなりません。

DomainCount

浮く

50

保護するドメイン名の数。

有効な値: 50 ~ 2000 値は10の倍数でなければなりません。

ServiceBandwidth

浮く

100

インスタンスによって提供されるクリーン帯域幅。 単位:Mbit/秒。

有効な値: 100〜5000。 値は50の倍数でなければなりません。

ベース帯域幅

浮く

30

基本的な保護帯域幅。 単位: Gbit/s。

有効な値は、30、60、100、300、400、500、600です。

帯域幅

浮く

50

バースト可能な保護帯域幅。 単位: Gbit/s。

バースト可能保護帯域幅は、基本保護帯域幅以上でなければならない。 Bandwidthの値は、BaseBandwidthの値によって異なります。

  • BaseBandwidthを30に設定すると、Bandwidthを30、40、50、60、70、80、100、150、200、または300に設定できます。

  • BaseBandwidthを60に設定すると、Bandwidthを60、70、80、100、150、200、300、400、500、または600に設定できます。

  • BaseBandwidthを100に設定すると、Bandwidthを100、150、200、300、400、500、または600に設定できます。

  • BaseBandwidthを300に設定すると、Bandwidthを300、400、500、または600に設定できます。

  • BaseBandwidthを400に設定すると、Bandwidthを400、500、または600に設定できます。

  • BaseBandwidthを500に設定すると、Bandwidthを500または600に設定できます。

  • BaseBandwidthを600に設定した場合、Bandwidthを600にのみ設定できます。

ServicePartner

String

coop-line-001

保護ラインのタイプ。 値をcoop-line-001に設定します。これはデフォルトの保護ラインを示します。

95BurstBandwidthMode

String

1

95パーセンタイルのバースト可能なクリーン帯域幅の計測方法。 有効な値:

  • 0: バースト可能なクリーン帯域幅機能を無効にします。

  • 1: バースト可能なクリーン帯域幅機能を有効にし、毎日95パーセンタイルメータリング方式を使用します。

  • 2: バースト可能なクリーン帯域幅機能を有効にし、毎月の95パーセンタイルメータリング方式を使用します。

AddressType

String

Ipv4

IPアドレスのIPバージョン。 有効な値:

  • Ipv4

  • Ipv6

Anti-DDoSプロキシ (中国本土以外) インスタンスの作成

CreateInstance操作を呼び出してAnti-DDoS Proxy (Outside Chinese Mainland) インスタンスを作成する場合、次の表に基づいてリクエストパラメーターを設定する必要があります。

説明

共通リクエストパラメーターの詳細については、「RPC APIのリクエスト構文と署名メソッドV2」をご参照ください。

表 3. Anti-DDoSプロキシ (中国本土以外) インスタンスの作成に使用されるリクエストパラメーター

パラメーター

データ型

必須

説明

Action

String

必須

CreateInstance

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

ProductCode

String

必須

ddos

インスタンスのサービスコード。

値をddosに設定します。これは、Anti-DDoS Proxyを指定します。

ProductType

String

必須

ddosDip

インスタンスのサービスタイプ。

値をddosDipに設定します。これは、Anti-DDoS Proxy (Outside Chinese Mainland) を示します。

SubscriptionType

String

必須

サブスクリプション

インスタンスの課金方法です。

値をサブスクリプションに設定します。これは、サブスクリプションの課金方法を示します。

Period

Integer

3

インスタンスのサブスクリプション期間。 単位:月。

有効な値: 361224

パラメータ。N. コード

String

必須

FunctionVersion

Parameter.N.Codeパラメーターは、インスタンスの設定項目Nを指定します。 Parameter.N.Valueパラメーターは、設定項目Nの値を指定します。

Parameter.N.CodeParameter.N.Valueのペアを指定して、アイテムを設定できます。 Nは、構成アイテムのシリアル番号を指定します。 たとえば、Parameter.1.CodeとParameter.1.Valueのペアは、最初の設定項目とその値を指定します。

詳細については、「Anti-DDoS Proxy (Outside Chinese Mainland) インスタンスの設定」をご参照ください。

パラメータ. N. 値

String

必須

0

RenewalStatus

String

任意

ManualRenewal

インスタンスの更新に使用されるメソッド。 有効な値:

  • ManualRenewal (デフォルト)

  • 自動更新

更新期間

Integer

いいえ

1

インスタンスの自動更新期間。 単位:月。

説明

RenewalStatusAutoRenewalに設定した場合、このパラメーターを指定する必要があります。

ClientToken

String

任意

123e4567-e89b-12d3-a456-42665544 ****

リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。 詳細については、「」をご参照ください。べき等性を確保するにはどうすればよいですか?

説明

このパラメーターを指定しない場合、システムは自動的にリクエストIDをクライアントトークンとして使用します。

Anti-DDoS Proxy (Outside Chinese Mainland) インスタンスを作成する場合、次の表に基づいて設定を完了するには、Parameter.N.CodeParameter.N.Valueのペアを指定する必要があります。

表 4. Anti-DDoSプロキシ (中国本土以外) インスタンスの設定

設定項目 (コード)

データ型

例 (値)

説明

Region

String

ap-southeast-1

インスタンスのリージョン ID です。 値をap-southeast-1に設定します。これは、中国本土以外を示します。

製品プラン

String

0

インスタンスの軽減プラン。 有効な値:

  • 0: 保険緩和プラン

  • 1: 無制限の緩和計画

  • 2: 中国本土加速 (CMA) 緩和計画

  • 3: 安全な中国本土加速 (Sec-CMA) 緩和計画

FunctionVersion

Strinig

0

インスタンスの関数プラン。 有効な値:

  • 0: 標準関数プラン

  • 1: 拡張関数プラン

説明

ProductPlanを2に設定した場合、このパラメーターを指定する必要はありません。

NormalQps

浮く

500

インスタンスによって提供されるクリーンなQPS。

NormalQpsの値は、ProductPlanの値によって異なります。

  • ProductPlanを0に設定すると、NormalQpsを500から100000の範囲の値に設定できます。 値は100の倍数でなければなりません。

  • ProductPlanを1に設定すると、NormalQpsを1000から100000の範囲の値に設定できます。 値は100の倍数でなければなりません。

  • ProductPlanを2に設定した場合、このパラメーターを指定する必要はありません。

  • ProductPlanを3に設定すると、NormalQpsを500から100000の範囲の値に設定できます。 値は100の倍数でなければなりません。

NormalBandwidth

String

100

インスタンスによって提供されるクリーン帯域幅。 単位:Mbit/秒。

NormalBandwidthの値は、ProductPlanの値によって異なります。

  • ProductPlanを0に設定すると、NormalBandwidthを100、150、200、250、または300に設定できます。

  • ProductPlanを1に設定すると、NormalBandwidthを100、150、200、250、または300に設定できます。

  • ProductPlanを2に設定すると、NormalBandwidthを10、20、30、40、50、60、70、80、90、または100に設定できます。

  • ProductPlanを3に設定すると、NormalBandwidthを10、20、30、40、50、60、70、80、90、100、150、または200に設定できます。

PortCount

浮く

5

保護するポートの数。

PortCountの値は、ProductPlanの値によって異なります。

  • ProductPlanを0に設定すると、PortCountを5から400の範囲の値に設定できます。 値は5の倍数でなければなりません。

  • ProductPlanを1に設定すると、PortCountを5から400の範囲の値に設定できます。 値は5の倍数でなければなりません。

  • ProductPlanを2に設定した場合、このパラメーターを指定する必要はありません。

  • ProductPlanを3に設定すると、PortCountを5から400の範囲の値に設定できます。 値は5の倍数でなければなりません。

DomainCount

浮く

10

保護するドメイン名の数。

DomainCountの値は、ProductPlanの値によって異なります。

  • ProductPlanを0に設定すると、DomainCountを10から200の範囲の値に設定できます。 値は10の倍数でなければなりません。

  • ProductPlanを1に設定すると、DomainCountを10から200の範囲の値に設定できます。 値は10の倍数でなければなりません。

  • ProductPlanを2に設定した場合、このパラメーターを指定する必要はありません。

  • ProductPlanを3に設定すると、DomainCountを10から200の範囲の値に設定できます。 値は10の倍数でなければなりません。

95BurstBandwidthMode

String

1

95パーセンタイルのバースト可能なクリーン帯域幅の計測方法。 有効な値:

  • 0: バースト可能なクリーン帯域幅機能を無効にします。

  • 1: バースト可能なクリーン帯域幅機能を有効にし、毎日95パーセンタイルメータリング方式を使用します。

  • 2: バースト可能なクリーン帯域幅機能を有効にし、毎月の95パーセンタイルメータリング方式を使用します。

レスポンスパラメーター

パラメーター

データ型

説明

Code

String

Success

HTTP ステータスコード

Data

Struct

応答パラメーター。

InstanceId

String

ddoscoo-cn-zvp28101 ****

作成されたインスタンスのID。

OrderId

String

20951253014 ****

注文 ID。

Message

String

成功!

返されるメッセージ。

RequestId

String

B03994C3-2A94-45FA-A44D-19E7BC39DC6D

リクエスト ID。

Success

Boolean

true

呼び出しが成功したかどうかを示します。 有効な値:

  • true: リクエストが成功しました。

  • false: リクエストが失敗しました。

  • 例1: Anti-DDoSプロキシ (中国本土) インスタンスの作成

    リクエストの例

    http(s)://[Endpoint]/?Action=CreateInstance
    &ProductCode=ddos
    &ProductType=ddoscoo
    &SubscriptionType=サブスクリプション
    &期間=1
    &Parameter.1.Code=エディション
    &Parameter.1.Value=coop
    &Parameter.2.Code=FunctionVersion
    &Parameter.2.Value=0
    &Parameter.3.Code=NormalQps
    &Parameter.3.Value=3000
    &Parameter.4.Code=PortCount
    &Parameter.4.Value=50
    &Parameter.5.Code=DomainCount
    &Parameter.5.Value=50
    &Parameter.6.Code=ServiceBandwidth
    &Parameter.6.Value=200
    &Parameter.7.Code=ベース帯域幅
    &Parameter.7.Value=30
    &Parameter.8.Code=帯域幅
    &Parameter.8.Value=50
    &Parameter.9.Code=ServicePartner
    &Parameter.9.Value='coop-line-001'
    &Parameter.10.Code=95BurstBandwidthMode
    &Parameter.10.Value='1'
    &Parameter.11.Code=AddressType
    &Parameter.11.Value='Ipv4'
    &<共通リクエストパラメーター>
    

    成功レスポンスの例

    • XML 形式

      HTTP/1.1 200 OK
      Content-Type:application/xml
      
      <CreateInstanceResponse>
          <RequestId>B03994C3-2A94-45FA-A44D-19E7BC39DC6D</RequestId>
          <メッセージ> 成功!</メッセージ>
          <Data>
              <InstanceId>ddoscoo-cn-zvp28101 ****</InstanceId>
              <OrderId>20951253014 ****</OrderId>
          </Data>
          <コード> 成功 </コード>
          <Success>true</Success>
      </CreateInstanceResponse> 
    • JSON形式

      HTTP/1.1 200 OK
      Content-Type:application/json
      
      {
        "RequestId": "B03994C3-2A94-45FA-A44D-19E7BC39DC6D" 、
        "Message": "Successful!",
        "Data": {
          "InstanceId": "ddoscoo-cn-zvp28101 ****" 、
          "OrderId": 20951253014 ****
        },
        "コード": "成功" 、
        "成功": 真
      } 
  • 例2: 保険軽減プランのAnti-DDoSプロキシ (中国本土以外) インスタンスの作成

    リクエストの例

    http(s)://[Endpoint]/?Action=CreateInstance
    &ProductCode=ddos
    &ProductType=ddosDip
    &SubscriptionType=サブスクリプション
    &期間=3
    &Parameter.1.Code=リージョン
    &Parameter.1.Value='ap-southeast-1'
    &Parameter.2.Code=ProductPlan
    &Parameter.2.Value=0
    &Parameter.3.Code=FunctionVersion
    &Parameter.3.Value=0
    &Parameter.4.Code=NormalQps
    &Parameter.4.Value=500
    &Parameter.5.Code=NormalBandwidth
    &Parameter.5.Value=100
    &Parameter.6.Code=PortCount
    &Parameter.6.Value=5
    &Parameter.7.Code=DomainCount
    &Parameter.7.Value=10
    &Parameter.8.Code=95BurstBandwidthMode
    &Parameter.8.Value='1'
    &<共通リクエストパラメーター>
    

    成功レスポンスの例

    • XML 形式

      HTTP/1.1 200 OK
      Content-Type:application/xml
      
      <CreateInstanceResponse>
          <RequestId>4DA44417-7BF7-474A-A3DC-D157EF6BD7CA</RequestId>
          <メッセージ> 成功!</メッセージ>
          <Data>
              <InstanceId>ddosDip-cn-i7m282j ****</InstanceId>
              <OrderId>20951829465 ****</OrderId>
          </Data>
          <コード> 成功 </コード>
          <Success>true</Success>
      </CreateInstanceResponse> 
    • JSON形式

      HTTP/1.1 200 OK
      Content-Type:application/json
      
      {
        "RequestId": "4DA44417-7BF7-474A-A3DC-D157EF6BD7CA" 、
        "Message": "Successful!",
        "Data": {
          "InstanceId": "ddosDip-cn-i7m282j ****" 、
          "OrderId": 20951829465 ****
        },
        "コード": "成功" 、
        "成功": 真
      } 
  • 例3: CMA軽減計画のAnti-DDoSプロキシ (中国本土以外) インスタンスの作成

    リクエストの例

    http(s)://[Endpoint]/?Action=CreateInstance
    &ProductCode=ddos
    &ProductType=ddosDip
    &SubscriptionType=サブスクリプション
    &期間=3
    &Parameter.1.Code=リージョン
    &Parameter.1.Value='ap-southeast-1'
    &Parameter.2.Code=ProductPlan
    &Parameter.2.Value=2
    &Parameter.3.Code=NormalBandwidth
    &Parameter.3.Value=10
    &Parameter.4.Code=95BurstBandwidthMode
    &Parameter.4.Value='1'
    &<共通リクエストパラメーター>
    

    成功レスポンスの例

    • XML 形式

      HTTP/1.1 200 OK
      Content-Type:application/xml
      
      <CreateInstanceResponse>
          <RequestId>4DA44417-7BF7-474A-A3DC-D157EF6BD7CA</RequestId>
          <メッセージ> 成功!</メッセージ>
          <Data>
              <InstanceId>ddosDip-cn-i7m282j ****</InstanceId>
              <OrderId>20951829465 ****</OrderId>
          </Data>
          <コード> 成功 </コード>
          <Success>true</Success>
      </CreateInstanceResponse> 
    • JSON形式

      HTTP/1.1 200 OK
      Content-Type:application/json
      
      {
        "RequestId": "4DA44417-7BF7-474A-A3DC-D157EF6BD7CA" 、
        "Message": "Successful!",
        "Data": {
          "InstanceId": "ddosDip-cn-i7m282j ****" 、
          "OrderId": 20951829465 ****
        },
        "コード": "成功" 、
        "成功": 真
      } 

関連ドキュメント

  • BSS APIの詳細については、「BSS APIの概要」をご参照ください。

  • 信用管理の詳細については、「」をご参照ください。

    信用管理