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

Anti-DDoS:API を使用した Anti-DDoS Proxy インスタンスの作成

最終更新日:Dec 26, 2025

Anti-DDoS Proxy には、インスタンス作成専用の API はありません。代わりに、Alibaba Cloud 取引・課金管理 API サービスの一部である CreateInstance API を呼び出すことができます。このトピックでは、この API を使用して Anti-DDoS Proxy インスタンスを作成する方法について説明します。

背景情報

Alibaba Cloud 取引・課金管理 API は、Alibaba Cloud リソースを管理するための一連の共通 API です。これらの API を使用して、サービス価格の照会、インスタンスの管理、課金情報の取得ができます。Alibaba Cloud 取引・課金管理 API がサポートする API の詳細については、「API の概要」をご参照ください。

CreateInstance - インスタンスの作成 API を呼び出して、Anti-DDoS Proxy インスタンスを作成できます。この API の呼び出し方法の詳細については、「V3 のリクエスト本文と署名メカニズム」をご参照ください。

注意事項

  • CreateInstance API を呼び出して Anti-DDoS Proxy インスタンスを作成すると、支払いは自動的に処理されます。インスタンス料金の詳細については、「課金の概要」をご参照ください。

  • 国際サイト (alibabacloud.com) のアカウントを使用して Anti-DDoS Proxy インスタンスを作成する場合、ご利用のアカウントにはクレジットコントロール ID が必要です。アカウントに ID がない場合は、ビジネス担当者に連絡してリクエストしてください。

中国本土向け Anti-DDoS Proxy インスタンスの作成

CreateInstance API を呼び出して中国本土向けの Anti-DDoS Proxy インスタンスを作成する場合、次の API リクエストパラメーターを設定します。

説明

この API の呼び出しに必要な共通リクエストパラメーターの詳細については、「署名メカニズム」をご参照ください。

表 1. リクエストパラメーター:中国本土向け Anti-DDoS Proxy インスタンスの作成

名前

タイプ

必須

説明

Action

String

はい

CreateInstance

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

ProductCode

String

はい

ddos

インスタンスが属するサービスのコード。

値を ddos に設定します。これは Anti-DDoS Proxy サービスを示します。

ProductType

String

はい

ddoscoo

インスタンスが属するサービスのタイプ。

有効な値:

  • ddoscoo:中国サイト (aliyun.com) の中国本土向け Anti-DDoS Proxy サービス。

  • ddoscoo_intl:国際サイト (alibabacloud.com) の中国本土向け Anti-DDoS Proxy サービス。

SubscriptionType

String

はい

Subscription

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

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

Period

Integer

はい

1

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

有効な値: 12345612、および 24

Parameter.N.Code

String

はい

FunctionVersion

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

Parameter.N.CodeParameter.N.Value のペアを指定して、インスタンス構成を設定します。N はパラメーターの序数です。たとえば、`Parameter.1.Code` と `Parameter.1.Value` は最初のパラメーターを指定します。

中国本土向け Anti-DDoS Proxy インスタンスの構成の詳細については、「中国本土向け Anti-DDoS Proxy インスタンスの構成」をご参照ください。

Parameter.N.Value

String

はい

0

RenewalStatus

String

いいえ

ManualRenewal

インスタンスの更新方法。有効な値:

  • ManualRenewal (デフォルト): 手動更新。

  • AutoRenewal: 自動更新。

RenewPeriod

Integer

いいえ

1

自動更新サイクル。単位: 月。

説明

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

ClientToken

String

いいえ

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

リクエストのべき等性を保証するためのクライアントトークン。各リクエストに対して一意のトークンを生成します。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。

説明

このパラメーターを設定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。

中国本土向けの Anti-DDoS Proxy インスタンスを作成する場合、Parameter.N.CodeParameter.N.Value のペアを使用して、次の表で説明するインスタンス構成を指定します。

表 2. 中国本土向け Anti-DDoS Proxy インスタンスの構成

パラメーター (コード)

タイプ

例 (値)

説明

AddressType

String

Ipv4

IP アドレスのプロトコルタイプ。有効な値:

  • IPv4:IPv4 プロトコルを指定します。

  • Ipv6: IPv6。

Edition

String

coop

保護プランのタイプ。値を coop に設定します。これはプロフェッショナル版を示します。

resourceb

String

shenzhendianxin

保護ノード。有効な値:

  • デフォルト: shenzhendianxin

  • 中国 (北京): cloudbeijing

  • 中国 (杭州): cloudhangzhou

ServicePartner

String

coop-line-001

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

BaseBandwidth

Float

30

基本保護帯域幅。単位: Gbps。

有効な値: 30、60、100、300、400、500、600、800、1000、および 1500。

Bandwidth

Float

50

バースト可能保護帯域幅。単位: Gbps。

このパラメーターの値は、BaseBandwidth の値以上である必要があります。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、800、1000、および 1500 です。

  • BaseBandwidth が 400 の場合、Bandwidth の有効な値は 400、500、600、800、1000、および 1500 です。

  • BaseBandwidth が 500 の場合、Bandwidth の有効な値は 500、600、800、1000、および 1500 です。

  • BaseBandwidth が 600 の場合、Bandwidth の有効な値は 600、800、1000、および 1500 です。

  • BaseBandwidth が 800 の場合、Bandwidth の有効な値は 800、1000、および 1500 です。

  • BaseBandwidth が 1000 の場合、Bandwidth の有効な値は 1000 と 1500 です。

  • BaseBandwidth が 1500 の場合、Bandwidth の有効な値は 1500 です。

ServiceBandwidth

Float

100

クリーン帯域幅。単位: Mbps。

値は 100 から 20,000 の範囲で 50 の倍数である必要があります。

95BurstBandwidthMode

String

1

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

  • 0:バースト可能クリーン帯域幅は無効です。

  • 1: 95 パーセンタイル バースト可能クリーン帯域幅は有効です。日次 95 パーセンタイル課金方法が使用されます。

  • 2: 95 パーセンタイル バースト可能クリーン帯域幅は有効です。月次 95 パーセンタイル課金方法が使用されます。

NormalQps

Float

3000

通常のクリーン トラフィックの秒間クエリ数 (QPS)。

値は 3,000 から 100,000 の範囲で 100 の倍数である必要があります。

95_burst_qps_mode

String

0

95 パーセンタイル バースト可能 QPS パターン。有効な値:

  • 0: バースト可能 QPS は無効です。

  • 1: バースト可能 QPS は有効です。日次 95 パーセンタイル課金方法が使用されます。

  • 2: バースト可能 QPS は有効です。月次 95 パーセンタイル課金方法が使用されます。

FunctionVersion

String

0

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

  • 値 0 は標準機能プランを表します。

  • 1: エンハンスドプラン。

DomainCount

Float

50

保護対象ドメイン名の数。

値は 50 から 2,000 の範囲で 10 の倍数である必要があります。

PortCount

Float

50

保護対象ポートの数。

値は 50 から 1,500 の範囲で 5 の倍数である必要があります。

中国本土以外のリージョン向け Anti-DDoS Proxy インスタンスの作成

CreateInstance API を呼び出して中国本土以外のリージョン向けの Anti-DDoS Proxy インスタンスを作成する場合、次の API リクエストパラメーターを設定します。

説明

この API の呼び出しに必要な共通リクエストパラメーターの詳細については、「署名メカニズム」をご参照ください。

表 3. リクエストパラメーター:中国本土以外のリージョン向け Anti-DDoS Proxy インスタンスの作成

名前

タイプ

必須

説明

Action

String

はい

CreateInstance

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

ProductCode

String

はい

ddos

インスタンスが属するサービスのコード。

値を ddos に設定します。これは Anti-DDoS Proxy サービスを示します。

ProductType

String

はい

ddosDip

インスタンスが属するサービスのタイプ。

値を ddosDip に設定します。これは中国本土以外のリージョン向けの Anti-DDoS Proxy サービスを示します。

SubscriptionType

String

はい

Subscription

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

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

Period

Integer

はい

3

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

有効な値: 12345612、および 24

Parameter.N.Code

String

はい

FunctionVersion

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

Parameter.N.CodeParameter.N.Value のペアを指定して、インスタンス構成を設定します。N はパラメーターの序数です。たとえば、`Parameter.1.Code` と `Parameter.1.Value` は最初のパラメーターを指定します。

中国本土以外のリージョン向け Anti-DDoS Proxy インスタンスの構成の詳細については、「中国本土以外のリージョン向け Anti-DDoS Proxy インスタンスの構成」をご参照ください。

Parameter.N.Value

String

はい

0

RenewalStatus

String

いいえ

ManualRenewal

インスタンスの更新方法。有効な値:

  • ManualRenewal (デフォルト): 手動更新。

  • AutoRenewal: 自動更新。

RenewPeriod

Integer

いいえ

1

自動更新サイクル。単位: 月。

説明

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

ClientToken

String

いいえ

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

リクエストのべき等性を保証するためのクライアントトークン。各リクエストに対して一意のトークンを生成します。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。

説明

このパラメーターを設定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。

中国本土以外のリージョン向けの Anti-DDoS Proxy インスタンスを作成する場合、Parameter.N.CodeParameter.N.Value のペアを使用して、次の表で説明するインスタンス構成を指定します。

表 4. 中国本土以外のリージョン向け Anti-DDoS Proxy インスタンスの構成

パラメーター (コード)

タイプ

例 (値)

説明

Region

String

ap-southeast-1

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

ProductPlan

String

0

インスタンスタイプ。有効な値:

  • 0: 保険緩和プラン。

  • 1: 無制限緩和プラン。

  • 2:CMA。

  • 3:Sec-CMA 1.0。

  • 12:Sec-CMA 2.0 (保険)。

  • 13:Sec-CMA 2.0 (無制限)。

  • 19:Sec-CMA 2.0

SecMitigation_spec

String

1

高度な緩和セッションの数。このパラメーターは、ProductPlan を 19 に設定して Sec-CMA 2.0 インスタンスを購入する場合にのみ必要です。有効値:0、1、2、31 (無制限)。

NormalBandwidth

String

100

クリーン帯域幅。単位: Mbps。

  • ProductPlan が 0 の場合、NormalBandwidth の有効な値は 100、150、200、250、300、400、500、600、700、800、900、1000、1500、2000、2500、3000、3500、4000、4500、および 5000 です。

  • ProductPlan が 1 の場合、NormalBandwidth の有効な値は 100、150、200、250、300、400、500、600、700、800、900、1000、1500、2000、2500、3000、3500、4000、4500、および 5000 です。

  • ProductPlan が 2 の場合、NormalBandwidth の有効な値は 10、20、30、40、50、60、70、80、90、100、150、200、250、300、400、500、600、700、800、900、および 1000 です。

  • ProductPlan が 3 の場合、NormalBandwidth の有効値は 10、20、30、40、50、60、70、80、90、100、150、200、250、300、400、500 です。

  • ProductPlan が 12、13、または 19 の場合、NormalBandwidth の有効値は 10、20、30、40、50、60、70、80、90、100、150、200、250、300、400、500、600、700、800、900、1000、1500 です。

95BurstBandwidthMode

String

1

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

  • 0:バースト可能クリーン帯域幅は無効です。

  • 1: 95 パーセンタイル バースト可能クリーン帯域幅は有効です。日次 95 パーセンタイル課金方法が使用されます。

  • 2: 95 パーセンタイル バースト可能クリーン帯域幅は有効です。月次 95 パーセンタイル課金方法が使用されます。

NormalQps

Float

500

クリーンな秒間クエリ数 (QPS)。

  • ProductPlan が 0 の場合、値は 500 から 150,000 の範囲で 100 の倍数である必要があります。

  • ProductPlan が 1 の場合、値は 1,000 から 150,000 の範囲で 100 の倍数である必要があります。

  • このパラメーターは、ProductPlan が 2 の場合は不要です。

  • ProductPlan が 3 の場合、値は 500 から 100,000 の範囲で 100 の倍数である必要があります。

  • ProductPlan が 12、13、または 19 の場合、値は 500 から 150,000 の範囲で 100 の倍数である必要があります。

95_burst_qps_mode

String

0

95 パーセンタイル バースト可能 QPS パターン。有効な値:

  • 0: バースト可能 QPS は無効です。

  • 1: バースト可能 QPS は有効です。日次 95 パーセンタイル課金方法が使用されます。

  • 2: バースト可能 QPS は有効です。月次 95 パーセンタイル課金方法が使用されます。

説明

このパラメーターは、ProductPlan を 2 に設定して CMA インスタンスを作成する場合には必要ありません。

FunctionVersion

String

0

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

  • 値 0 は標準機能プランを表します。

  • 1: エンハンスドプラン。

説明

このパラメーターは、ProductPlan を 2 に設定して CMA インスタンスを作成する場合には必要ありません。

DomainCount

Float

10

保護対象ドメイン名の数。

  • ProductPlan が 0、1、3、12、13、または 19 の場合、値は 10 から 2,000 の範囲で 10 の倍数である必要があります。

  • ProductPlan を 2 に設定した場合、DomainCount は不要です。

PortCount

Float

5

保護対象ポートの数。

  • ProductPlan が 0、1、3、12、13、または 19 の場合、値は 5 から 1,500 の範囲で 5 の倍数である必要があります。

  • ProductPlan を 2 に設定した場合、PortCount は不要です。

応答データ

名前

タイプ

説明

Code

String

Success

HTTP ステータスコード。

Data

Struct

返されたデータ。

InstanceId

String

ddoscoo-cn-zvp28101****

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

OrderId

String

20951253014****

生成された注文の ID。

Message

String

Successful!

応答メッセージ。

RequestId

String

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

リクエストの ID。

Success

Boolean

true

リクエストが成功したかどうかを示します。有効な値:

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

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

  • 例 1:中国本土向け Anti-DDoS Proxy インスタンスの作成

    リクエストの例

    http(s)://[Endpoint]/?Action=CreateInstance
    &ProductCode=ddos
    &ProductType=ddoscoo
    &SubscriptionType=Subscription
    &Period=1
    &Parameter.1.Code=Edition
    &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=BaseBandwidth
    &Parameter.7.Value=30
    &Parameter.8.Code=Bandwidth
    &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'
    &<Common request parameters>

    レスポンスの例

    • XML フォーマット

      HTTP/1.1 200 OK
      Content-Type:application/xml
      
      <CreateInstanceResponse>
          <RequestId>B03994C3-2A94-45FA-A44D-19E7BC39DC6D</RequestId>
          <Message>Successful!</Message>
          <Data>
              <InstanceId>ddoscoo-cn-zvp28101****</InstanceId>
              <OrderId>20951253014****</OrderId>
          </Data>
          <Code>Success</Code>
          <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****"
        },
        "Code": "Success",
        "Success": true
      }
  • 例 2:中国本土以外のリージョン向け Anti-DDoS Proxy インスタンス (保険) の作成

    リクエストの例

    http(s)://[Endpoint]/?Action=CreateInstance
    &ProductCode=ddos
    &ProductType=ddosDip
    &SubscriptionType=Subscription
    &Period=3
    &Parameter.1.Code=Region
    &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'
    &<Common request parameters>

    レスポンスの例

    • XML フォーマット

      HTTP/1.1 200 OK
      Content-Type:application/xml
      
      <CreateInstanceResponse>
          <RequestId>4DA44417-7BF7-474A-A3DC-D157EF6BD7CA</RequestId>
          <Message>Successful!</Message>
          <Data>
              <InstanceId>ddosDip-cn-i7m282j****</InstanceId>
              <OrderId>20951829465****</OrderId>
          </Data>
          <Code>Success</Code>
          <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****"
        },
        "Code": "Success",
        "Success": true
      }
  • 例 3:中国本土以外のリージョン向け Anti-DDoS Proxy の CMA プランの作成

    リクエストの例

    http(s)://[Endpoint]/?Action=CreateInstance
    &ProductCode=ddos
    &ProductType=ddosDip
    &SubscriptionType=Subscription
    &Period=3
    &Parameter.1.Code=Region
    &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'
    &<Common request parameters>

    正常な応答の例

    • XML フォーマット

      HTTP/1.1 200 OK
      Content-Type:application/xml
      
      <CreateInstanceResponse>
          <RequestId>4DA44417-7BF7-474A-A3DC-D157EF6BD7CA</RequestId>
          <Message>Successful!</Message>
          <Data>
              <InstanceId>ddosDip-cn-i7m282j****</InstanceId>
              <OrderId>20951829465****</OrderId>
          </Data>
          <Code>Success</Code>
          <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****"
        },
        "Code": "Success",
        "Success": true
      }

関連リファレンス

  • Alibaba Cloud 取引および課金管理 API の詳細については、「API の概要」をご参照ください。

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