DDoS高防(中國內地&非中國內地)不提供創建實例的接口,您可以調用阿里云交易和賬單管理API提供的CreateInstance接口來創建實例。本文介紹如何調用API創建DDoS高防實例。
背景信息
阿里云交易和賬單管理API是一套通用的管理阿里云資源的接口,可以用于查詢服務價格、管理實例、獲取賬單信息等。關于阿里云交易和賬單管理API支持的所有接口,請參見API概覽。
您可以調用阿里云交易和賬單管理API提供的CreateInstance - 實例創建服務接口,創建DDoS高防實例。關于該接口的調用方式,請參見簽名機制。
注意事項
調用CreateInstance接口創建DDoS高防實例后,會自動支付。實例的費用詳情,請參見計費說明。
使用國際站賬號創建DDoS高防實例時,賬號必須開通信控身份。如未開通信控身份,請聯系商務經理申請開通。
創建DDoS高防(中國內地)實例
您在調用CreateInstance接口創建DDoS高防(中國內地)實例時,需要完成以下API請求參數設置。
關于調用該接口所需的公共請求參數,請參見簽名機制。
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
Action | String | 是 | CreateInstance | 要執行的操作。取值:CreateInstance。 |
ProductCode | String | 是 | ddos | 實例所屬服務的代碼。 取值:ddos,表示DDoS高防服務。 |
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配對,表示第1項配置。 關于DDoS高防(中國內地)實例的具體配置,請參見DDoS高防(中國內地)實例配置。 |
Parameter.N.Value | String | 是 | 0 | |
RenewalStatus | String | 否 | ManualRenewal | 實例的續費方式。取值:
|
RenewPeriod | Integer | 否 | 1 | 自動續費周期, 單位:月。 說明 RenewalStatus為AutoRenewal(表示開啟自動續費)時,必須設置該參數。 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 保證請求冪等性。從您的客戶端生成一個參數值,確保不同請求間該參數值唯一。ClientToken只支持ASCII字符,且不能超過64個字符。更多信息,請參見如何保證冪等性。 說明 如果不設置該參數,則系統自動使用API請求的RequestId作為ClientToken標識。 |
創建DDoS高防(中國內地)實例時,您需要通過Parameter.N.Code和Parameter.N.Value對,完成下表描述的實例配置。
配置項(Code) | 類型 | 示例值(Value) | 描述 |
Edition | String | coop | 防護套餐類型。取值:coop,表示專業版。 |
FunctionVersion | String | 0 | 功能套餐類型。取值:
|
NormalQps | Float | 3000 | 正常業務QPS。 取值范圍:3000~100000,必須是100的整數倍。 |
PortCount | Float | 50 | 防護端口數。 取值范圍:50~400,必須是5的整數倍。 |
DomainCount | Float | 50 | 防護域名數。 取值范圍:50~2000,必須是10的整數倍。 |
ServiceBandwidth | Float | 100 | 業務帶寬,單位:Mbps。 取值范圍:100~5000,必須是50的整數倍。 |
BaseBandwidth | Float | 30 | 保底防護帶寬,單位:Gbps。 取值:30、60、100、300、400、500、600。 |
Bandwidth | Float | 50 | 彈性防護帶寬,單位:Gbps。 彈性防護帶寬必須大于或等于保底防護帶寬。不同保底防護帶寬(BaseBandwidth)支持的彈性防護帶寬(Bandwidth)取值不同。具體說明如下:
|
ServicePartner | String | coop-line-001 | 防護線路類型。取值:coop-line-001,表示默認防護線路。 |
95BurstBandwidthMode | String | 1 | 95彈性業務帶寬計費模式。取值:
|
AddressType | String | Ipv4 | IP地址的協議類型。取值:
|
創建DDoS高防(非中國內地)實例
您在調用CreateInstance接口創建DDoS高防(非中國內地)實例時,需要完成以下API請求參數設置。
關于調用該接口所需的公共請求參數,請參見簽名機制。
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
Action | String | 是 | CreateInstance | 要執行的操作。取值:CreateInstance。 |
ProductCode | String | 是 | ddos | 實例所屬服務的代碼。 取值:ddos,表示DDoS高防服務。 |
ProductType | String | 是 | ddosDip | 實例所屬服務的類型。 取值:ddosDip,表示DDoS高防(非中國內地)服務。 |
SubscriptionType | String | 是 | Subscription | 實例的計費方式。 取值:Subscription,表示包年包月方式。 |
Period | Integer | 是 | 3 | 購買時長,單位:月。 取值:3、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配對,表示第1項配置。 關于DDoS高防(非中國內地)實例的具體配置,請參見DDoS高防(非中國內地)實例配置。 |
Parameter.N.Value | String | 是 | 0 | |
RenewalStatus | String | 否 | ManualRenewal | 實例的續費方式。取值:
|
RenewPeriod | Integer | 否 | 1 | 自動續費周期, 單位:月。 說明 RenewalStatus為AutoRenewal(表示開啟自動續費)時,必須設置該參數。 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 保證請求冪等性。從您的客戶端生成一個參數值,確保不同請求間該參數值唯一。ClientToken只支持ASCII字符,且不能超過64個字符。更多信息,請參見如何保證冪等性。 說明 如果不設置該參數,則系統自動使用API請求的RequestId作為ClientToken標識。 |
創建DDoS高防(非中國內地)實例時,您需要通過Parameter.N.Code和Parameter.N.Value對,完成下表描述的實例配置。
配置項(Code) | 類型 | 示例值(Value) | 描述 |
Region | String | ap-southeast-1 | 服務地域。取值:ap-southeast-1,表示海外地區。 |
ProductPlan | String | 0 | 實例類型。取值:
|
FunctionVersion | Strinig | 0 | 功能套餐類型。取值:
說明 ProductPlan為2(表示創建加速線路實例)時,無需配置該參數。 |
NormalQps | Float | 500 | 業務QPS。 不同實例類型(ProductPlan)支持的業務QPS(NormalQps)取值范圍不同。具體說明如下:
|
NormalBandwidth | String | 100 | 業務帶寬,單位:Mbps。 不同實例類型(ProductPlan)支持的業務帶寬(NormalBandwidth)取值不同。具體說明如下:
|
PortCount | Float | 5 | 防護端口數。 不同實例類型(ProductPlan)支持的防護端口數(PortCount)取值范圍不同。具體說明如下:
|
DomainCount | Float | 10 | 防護域名數。 不同實例類型(ProductPlan)支持的防護域名數(DomainCount)取值范圍不同。具體說明如下:
|
95BurstBandwidthMode | String | 1 | 95彈性業務帶寬計費模式。取值:
|
返回數據
名稱 | 類型 | 示例值 | 描述 |
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:創建DDoS高防(中國內地)實例
請求示例
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' &<公共請求參數>
正常返回示例
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:創建DDoS高防(非中國內地)保險版實例
請求示例
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' &<公共請求參數>
正常返回示例
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:創建DDoS高防(非中國內地)加速線路實例
請求示例
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' &<公共請求參數>
正常返回示例
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 }
相關文檔
關于阿里云交易和賬單管理API的詳細介紹,請參見交易和賬單管理API介紹。
關于信控的詳細介紹,請參見信控管理。