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 | インスタンスが属するサービスのタイプ。 有効な値:
|
SubscriptionType | String | はい | Subscription | インスタンスの課金方法。 値を Subscription に設定します。これはサブスクリプション課金方法を示します。 |
Period | Integer | はい | 1 | サブスクリプション期間。単位: 月。 有効な値: 1、2、3、4、5、6、12、および 24。 |
Parameter.N.Code | String | はい | FunctionVersion | Parameter.N.Code はインスタンスパラメーターを指定し、Parameter.N.Value はその項目の値を指定します。 Parameter.N.Code と Parameter.N.Value のペアを指定して、インスタンス構成を設定します。N はパラメーターの序数です。たとえば、`Parameter.1.Code` と `Parameter.1.Value` は最初のパラメーターを指定します。 中国本土向け Anti-DDoS Proxy インスタンスの構成の詳細については、「中国本土向け Anti-DDoS Proxy インスタンスの構成」をご参照ください。 |
Parameter.N.Value | String | はい | 0 | |
RenewalStatus | String | いいえ | ManualRenewal | インスタンスの更新方法。有効な値:
|
RenewPeriod | Integer | いいえ | 1 | 自動更新サイクル。単位: 月。 説明 このパラメーターは、RenewalStatus が AutoRenewal に設定されている場合にのみ必須です。 |
ClientToken | String | いいえ | 123e4567-e89b-12d3-a456-42665544**** | リクエストのべき等性を保証するためのクライアントトークン。各リクエストに対して一意のトークンを生成します。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。 説明 このパラメーターを設定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。 |
中国本土向けの Anti-DDoS Proxy インスタンスを作成する場合、Parameter.N.Code と Parameter.N.Value のペアを使用して、次の表で説明するインスタンス構成を指定します。
表 2. 中国本土向け Anti-DDoS Proxy インスタンスの構成
パラメーター (コード) | タイプ | 例 (値) | 説明 |
AddressType | String | Ipv4 | IP アドレスのプロトコルタイプ。有効な値:
|
Edition | String | coop | 保護プランのタイプ。値を coop に設定します。これはプロフェッショナル版を示します。 |
resourceb | String | shenzhendianxin | 保護ノード。有効な値:
|
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 の値によって異なります。詳細は次のとおりです:
|
ServiceBandwidth | Float | 100 | クリーン帯域幅。単位: Mbps。 値は 100 から 20,000 の範囲で 50 の倍数である必要があります。 |
95BurstBandwidthMode | String | 1 | 95 パーセンタイル バースト可能クリーン帯域幅の課金方法。有効な値:
|
NormalQps | Float | 3000 | 通常のクリーン トラフィックの秒間クエリ数 (QPS)。 値は 3,000 から 100,000 の範囲で 100 の倍数である必要があります。 |
95_burst_qps_mode | String | 0 | 95 パーセンタイル バースト可能 QPS パターン。有効な値:
|
FunctionVersion | String | 0 | プランのタイプ。有効な値:
|
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 | サブスクリプション期間。単位: 月。 有効な値: 1、2、3、4、5、6、12、および 24。 |
Parameter.N.Code | String | はい | FunctionVersion | Parameter.N.Code はインスタンスパラメーターを指定し、Parameter.N.Value はその項目の値を指定します。 Parameter.N.Code と Parameter.N.Value のペアを指定して、インスタンス構成を設定します。N はパラメーターの序数です。たとえば、`Parameter.1.Code` と `Parameter.1.Value` は最初のパラメーターを指定します。 中国本土以外のリージョン向け Anti-DDoS Proxy インスタンスの構成の詳細については、「中国本土以外のリージョン向け Anti-DDoS Proxy インスタンスの構成」をご参照ください。 |
Parameter.N.Value | String | はい | 0 | |
RenewalStatus | String | いいえ | ManualRenewal | インスタンスの更新方法。有効な値:
|
RenewPeriod | Integer | いいえ | 1 | 自動更新サイクル。単位: 月。 説明 このパラメーターは、RenewalStatus が AutoRenewal に設定されている場合にのみ必須です。 |
ClientToken | String | いいえ | 123e4567-e89b-12d3-a456-42665544**** | リクエストのべき等性を保証するためのクライアントトークン。各リクエストに対して一意のトークンを生成します。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。 説明 このパラメーターを設定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。 |
中国本土以外のリージョン向けの Anti-DDoS Proxy インスタンスを作成する場合、Parameter.N.Code と Parameter.N.Value のペアを使用して、次の表で説明するインスタンス構成を指定します。
表 4. 中国本土以外のリージョン向け Anti-DDoS Proxy インスタンスの構成
パラメーター (コード) | タイプ | 例 (値) | 説明 |
Region | String | ap-southeast-1 | サービスリージョン。値を ap-southeast-1 に設定します。これは中国本土以外のリージョンを示します。 |
ProductPlan | String | 0 | インスタンスタイプ。有効な値:
|
SecMitigation_spec | String | 1 | 高度な緩和セッションの数。このパラメーターは、ProductPlan を 19 に設定して Sec-CMA 2.0 インスタンスを購入する場合にのみ必要です。有効値:0、1、2、31 (無制限)。 |
NormalBandwidth | String | 100 | クリーン帯域幅。単位: Mbps。
|
95BurstBandwidthMode | String | 1 | 95 パーセンタイル バースト可能クリーン帯域幅の課金方法。有効な値:
|
NormalQps | Float | 500 | クリーンな秒間クエリ数 (QPS)。
|
95_burst_qps_mode | String | 0 | 95 パーセンタイル バースト可能 QPS パターン。有効な値:
説明 このパラメーターは、ProductPlan を 2 に設定して CMA インスタンスを作成する場合には必要ありません。 |
FunctionVersion | String | 0 | プランのタイプ。有効な値:
説明 このパラメーターは、ProductPlan を 2 に設定して CMA インスタンスを作成する場合には必要ありません。 |
DomainCount | Float | 10 | 保護対象ドメイン名の数。
|
PortCount | Float | 5 | 保護対象ポートの数。
|
応答データ
名前 | タイプ | 例 | 説明 |
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 | リクエストが成功したかどうかを示します。有効な値:
|
例
例 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 }