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

Anti-DDoS:APIを呼び出してAnti-DDoSオリジン2.0 (サブスクリプション) インスタンスを作成する

最終更新日:Nov 19, 2024

Anti-DDoS Originは、インスタンスを作成するためのAPI操作を提供しません。 インスタンスを作成するには、Alibaba Cloud Transactions and Bills Management API (略してBSS APIとも呼ばれます) が提供するCreateInstance操作を呼び出します。 このトピックでは、API操作を呼び出してAnti-DDoS Originを作成する方法について説明します。2.0 (サブスクリプション)インスタンスを作成します。

背景情報

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

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

注意事項

  • APIを呼び出すことで、Anti-DDoSオリジン2.0 (サブスクリプション) インスタンスのみを作成できます。 インスタンスエディションは、中小企業またはエンタープライズ向けの包括的エディションにすることができます。

  • CreateInstance操作を呼び出してAnti-DDoS Originインスタンスを作成すると、インスタンスの料金がアカウントの残高から自動的に差し引かれます。 料金の詳細については、「Anti-DDoSオリジン2.0 (サブスクリプション) 」をご参照ください。

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

中小企業向けのInclusive EditionのAnti-DDoS Origin 2.0インスタンスの作成

リクエストパラメーター

パラメーター

タイプ

必須

説明

Action

String

必須

CreateInstance

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

ProductCode

String

必須

ddos

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

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

ProductType

String

必須

ddos_originpre_public_cn

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

有効な値:

  • ddos_originpre_public_cn: 中国サイトのAnti-DDoSオリジン (aliyun.com) 。

  • ddos_ddosbgp_public_intl: 国際サイト (alibabacloud.com) のAnti-DDoS Origin。

SubscriptionType

String

必須

サブスクリプション

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

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

Period

Integer

必須

1

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

有効な値: 1、2、3、4、5、6、12、24、および36。

RenewalStatus

String

任意

ManualRenewal

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

  • ManualRenewal (デフォルト)

  • AutoRenewal

更新期間

Integer

選択可能

1

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

説明

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

ClientToken

String

任意

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

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

説明

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

パラメータ。N. コード

String

必須

mitigation_analysis

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

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

パラメータ. N. 値

String

必須

off

Parameter.N.CodeおよびParameter.N.Value

設定項目 (コード)

タイプ

例 (値)

説明

エディション

String

smb

インスタンスのエディション。 値をsmbに設定します。これは、中小企業向けのInclusive EditionのAnti-DDoSオリジン2.0を示します。

internet_protocol

String

v4

インスタンスのIPバージョン。 有効な値:

  • v4: IPv4。

  • v6: IPv6

ip_qty

Integer

3

保護するIPアドレスの数。 有効な値: 1 ~ 29。

mitigation_qty_monthly

String

2

緩和計画。 値を 2 に設定します。 値2は、毎月2回の軽減セッションを提供する保険軽減プランを示します。

カバレッジ

String

1_region

保護するアセットのリージョン。 値を1_regionに設定します。これは、インスタンスが単一のリージョンのアセットのみを保護できることを示します。

clean_bandwidth

Integer

50

インスタンスによって提供されるクリーン帯域幅。 単位は、Mbit/s です。

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

mitigation_analysis

String

off

軽減ログ機能を有効にするかどうかを指定します。 値をoffに設定します。これは、機能が無効になっていることを示します。

説明

中小企業向けのInclusive EditionのAnti-DDoS Origin 2.0の軽減ログ機能を有効にすることはできません。

サンプルリクエスト

{
        "ProductCode": "ddos",
        "ProductType": "ddos_originpre_public_cn", 
        "Parameter.1.Code": "edition", 
        "Parameter.1.Value": "smb",
        "Parameter.2.Code": "internet_protocol",
        "Parameter.2.Value": "v4",
        "Parameter.3.Code": "ip_qty", 
        "Parameter.3.Value": "3",
        "Parameter.4.Code": "mitigation_qty_monthly",
        "Parameter.4.Value": "2",
        "Parameter.5.Code": "coverage", 
        "Parameter.5.Value": "1_region", 
        "Parameter.6.Code": "clean_bandwidth", 
        "Parameter.6.Value": "50",
        "Parameter.7.Code": "mitigation_analysis", 
        "Parameter.7.Value": "off",
        "SubscriptionType": "Subscription",
        "Period": "1",
        "RenewalStatus": "AutoRenewal",
        "RenewPeriod": "1"
    }

サンプル応答

{
  "Message": "Successful!",
  "RequestId": "A09C6A09-D399-5075-98D8-0A2D341EAC69",
  "Data": {
    "InstanceId": "ddos_originpre_public_cn-j4g3yvg****",
    "OrderId": 24005131779****
  },
  "Code": "Success",
  "Success": true
}

Anti-DDoS Origin 2.0エンタープライズインスタンスの作成

リクエストパラメーター

パラメーター

タイプ

必須

説明

Action

String

必須

CreateInstance

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

ProductCode

String

必須

ddos

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

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

ProductType

String

必須

ddos_originpre_public_cn

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

有効な値:

  • ddos_originpre_public_cn: 中国サイトのAnti-DDoSオリジン (aliyun.com) 。

  • ddos_ddosbgp_public_intl: 国際サイト (alibabacloud.com) のAnti-DDoS Origin。

SubscriptionType

String

必須

サブスクリプション

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

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

Period

Integer

必須

1

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

有効な値: 1、2、3、4、5、6、12、24、および36。

RenewalStatus

String

任意

ManualRenewal

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

  • ManualRenewal (デフォルト)

  • AutoRenewal

更新期間

Integer

選択可能

1

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

説明

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

ClientToken

String

任意

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

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

説明

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

パラメータ。N. コード

String

必須

mitigation_analysis

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

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

パラメータ. N. 値

String

必須

off

Parameter.N.CodeおよびParameter.N.Value

設定項目 (コード)

タイプ

例 (値)

説明

エディション

String

enterprise

インスタンスのエディション。 値をエンタープライズに設定します。これは、Anti-DDoS Origin 2.0 enterpriseを示します。

internet_protocol

String

v4_6

インスタンスのIPバージョン。 値をv4_6に設定します。これは、IPv4とIPv6がサポートされていることを示します。

ip_qty

Integer

30

保護するIPアドレスの数。 有効な値: 30 ~ 10000000

mitigation_qty_monthly

String

無制限

緩和計画。 有効な値:

  • 2: 毎月2つの緩和セッションを提供する保険緩和プラン。

  • unlimited: 1か月あたり無制限の軽減セッションを提供する無制限の軽減プラン。

説明

中国サイト (aliyun.com) ユーザーは、パラメーターを2にのみ設定できます。 国際サイト (alibabacloud.com) ユーザーは、パラメーターを2または無制限に設定できます。

カバレッジ

String

only_mainland_china

保護するアセットのリージョン。 有効な値:

  • only_mainland_china: 中国本土のリージョン。

  • international_and_hmt: 中国本土以外の地域。

  • global: 中国本土内外の地域。

説明

中国サイト (aliyun.com) ユーザーは、パラメーターをonly_mainland_chinaにのみ設定できます。 国際サイト (alibabacloud.com) ユーザーは、パラメーターをonly_mainland_china、international_and_hmt、またはglobalに設定できます。

clean_bandwidth

Integer

100

インスタンスによって提供されるクリーン帯域幅。 単位は、Mbit/s です。

有効な値: 100〜900000。 値は100の整数倍である必要があります。

mitigation_analysis

String

on

軽減ログ機能を有効にするかどうかを指定します。 有効な値:

  • on: 軽減ログ機能が有効になっています。

  • off: 軽減ログ機能は無効です。

mitigation_analysis_capacity

String

3 T

ログストレージ容量。 値を3Tに設定します。これは、ログストレージ容量の3テラバイトを示します。

説明

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

サンプルリクエスト

{
        "ProductCode": "ddos",
        "ProductType": "ddos_originpre_public_cn",
        "Parameter.1.Code": "edition",
        "Parameter.1.Value": "enterprise",
        "Parameter.2.Code": "internet_protocol",
        "Parameter.2.Value": "v4_6",
        "Parameter.3.Code": "ip_qty",
        "Parameter.3.Value": "30",
        "Parameter.4.Code": "mitigation_qty_monthly",
        "Parameter.4.Value": "unlimited",
        "Parameter.5.Code": "coverage",
        "Parameter.5.Value": "only_mainland_china", 
        "Parameter.6.Code": "clean_bandwidth",
        "Parameter.6.Value": "100",
        "Parameter.7.Code": "mitigation_analysis",
        "Parameter.7.Value": "on", 
        "Parameter.8.Code": "mitigation_analysis_capacity",
        "Parameter.8.Value": "3T",
        "SubscriptionType": "Subscription",
        "Period": "1",
        "RenewalStatus": "AutoRenewal",
        "RenewPeriod": "1"

    }

サンプル応答

{
  "Message": "Successful!",
  "RequestId": "09B48D51-AD06-5D95-8C0A-4BCD2E406F0C",
  "Data": {
    "InstanceId": "ddos_originpre_public_cn-lf63yvl****",
    "OrderId": 24005235006****
  },
  "Code": "Success",
  "Success": true
}