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」をご参照ください。
パラメーター | データ型 | 必須 | 例 | 説明 |
Action | String | 必須 | CreateInstance | 実行する操作です。 値をCreateInstanceに設定します。 |
ProductCode | String | 必須 | ddos | インスタンスのサービスコード。 値をddosに設定します。これは、Anti-DDoS Proxyを指定します。 |
ProductType | String | 必須 | ddoscoo | インスタンスのサービスタイプ。 有効な値:
|
SubscriptionType | String | 必須 | サブスクリプション | インスタンスの課金方法です。 値をサブスクリプションに設定します。これは、サブスクリプションの課金方法を示します。 |
Period | Integer | 可 | 1 | インスタンスのサブスクリプション期間。 単位:月。 有効な値: 1、2、3、4、5、6、12、24 |
パラメータ。N. コード | String | 必須 | FunctionVersion | Parameter.N.Codeパラメーターは、インスタンスの設定項目Nを指定します。 Parameter.N.Valueパラメーターは、設定項目Nの値を指定します。 Parameter.N.CodeとParameter.N.Valueのペアを指定して、アイテムを設定できます。 Nは、構成アイテムのシリアル番号を指定します。 たとえば、Parameter.1.CodeとParameter.1.Valueのペアは、最初の設定項目とその値を指定します。 詳細については、「Anti-DDoS Proxy (中国本土) インスタンスの設定」をご参照ください。 |
パラメータ. N. 値 | String | 必須 | 0 | |
RenewalStatus | String | 任意 | ManualRenewal | インスタンスの更新に使用されるメソッド。 有効な値:
|
更新期間 | Integer | いいえ | 1 | インスタンスの自動更新期間。 単位:月。 説明 RenewalStatusをAutoRenewalに設定した場合、このパラメーターを指定する必要があります。 |
ClientToken | String | 任意 | 123e4567-e89b-12d3-a456-42665544 **** | リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。 詳細については、「」をご参照ください。べき等性を確保するにはどうすればよいですか? 説明 このパラメーターを指定しない場合、システムは自動的にリクエストIDをクライアントトークンとして使用します。 |
Anti-DDoS Proxy (中国本土) インスタンスを作成する場合、次の表に基づいて設定を完了するには、Parameter.N.CodeとParameter.N.Valueのペアを指定する必要があります。
設定項目 (コード) | データ型 | 例 (値) | 説明 |
エディション | String | 小屋 | インスタンスの軽減プラン。 値をcoopに設定します。これは、職業軽減計画を示します。 |
FunctionVersion | String | 0 | インスタンスの関数プラン。 有効な値:
|
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の値によって異なります。
|
ServicePartner | String | coop-line-001 | 保護ラインのタイプ。 値をcoop-line-001に設定します。これはデフォルトの保護ラインを示します。 |
95BurstBandwidthMode | String | 1 | 95パーセンタイルのバースト可能なクリーン帯域幅の計測方法。 有効な値:
|
AddressType | String | Ipv4 | IPアドレスのIPバージョン。 有効な値:
|
Anti-DDoSプロキシ (中国本土以外) インスタンスの作成
CreateInstance操作を呼び出してAnti-DDoS Proxy (Outside Chinese Mainland) インスタンスを作成する場合、次の表に基づいてリクエストパラメーターを設定する必要があります。
共通リクエストパラメーターの詳細については、「RPC APIのリクエスト構文と署名メソッドV2」をご参照ください。
パラメーター | データ型 | 必須 | 例 | 説明 |
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 | インスタンスのサブスクリプション期間。 単位:月。 有効な値: 3、6、12、24 |
パラメータ。N. コード | String | 必須 | FunctionVersion | Parameter.N.Codeパラメーターは、インスタンスの設定項目Nを指定します。 Parameter.N.Valueパラメーターは、設定項目Nの値を指定します。 Parameter.N.CodeとParameter.N.Valueのペアを指定して、アイテムを設定できます。 Nは、構成アイテムのシリアル番号を指定します。 たとえば、Parameter.1.CodeとParameter.1.Valueのペアは、最初の設定項目とその値を指定します。 詳細については、「Anti-DDoS Proxy (Outside Chinese Mainland) インスタンスの設定」をご参照ください。 |
パラメータ. N. 値 | String | 必須 | 0 | |
RenewalStatus | String | 任意 | ManualRenewal | インスタンスの更新に使用されるメソッド。 有効な値:
|
更新期間 | Integer | いいえ | 1 | インスタンスの自動更新期間。 単位:月。 説明 RenewalStatusをAutoRenewalに設定した場合、このパラメーターを指定する必要があります。 |
ClientToken | String | 任意 | 123e4567-e89b-12d3-a456-42665544 **** | リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。 詳細については、「」をご参照ください。べき等性を確保するにはどうすればよいですか? 説明 このパラメーターを指定しない場合、システムは自動的にリクエストIDをクライアントトークンとして使用します。 |
Anti-DDoS Proxy (Outside Chinese Mainland) インスタンスを作成する場合、次の表に基づいて設定を完了するには、Parameter.N.CodeとParameter.N.Valueのペアを指定する必要があります。
設定項目 (コード) | データ型 | 例 (値) | 説明 |
Region | String | ap-southeast-1 | インスタンスのリージョン ID です。 値をap-southeast-1に設定します。これは、中国本土以外を示します。 |
製品プラン | String | 0 | インスタンスの軽減プラン。 有効な値:
|
FunctionVersion | Strinig | 0 | インスタンスの関数プラン。 有効な値:
説明 ProductPlanを2に設定した場合、このパラメーターを指定する必要はありません。 |
NormalQps | 浮く | 500 | インスタンスによって提供されるクリーンなQPS。 NormalQpsの値は、ProductPlanの値によって異なります。
|
NormalBandwidth | String | 100 | インスタンスによって提供されるクリーン帯域幅。 単位:Mbit/秒。 NormalBandwidthの値は、ProductPlanの値によって異なります。
|
PortCount | 浮く | 5 | 保護するポートの数。 PortCountの値は、ProductPlanの値によって異なります。
|
DomainCount | 浮く | 10 | 保護するドメイン名の数。 DomainCountの値は、ProductPlanの値によって異なります。
|
95BurstBandwidthMode | String | 1 | 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 | 呼び出しが成功したかどうかを示します。 有効な値:
|
例
例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の概要」をご参照ください。
信用管理の詳細については、「」をご参照ください。
信用管理