DDoS高防(中国内地&非中国内地)不提供创建实例的接口,您可以调用阿里云交易和账单管理API提供的CreateInstance接口来创建实例。本文介绍如何调用API创建DDoS高防实例。
背景信息
阿里云交易和账单管理API是一套通用的管理阿里云资源的接口,可以用于查询服务价格、管理实例、获取账单信息等。关于阿里云交易和账单管理API支持的所有接口,请参见API概览。
您可以调用阿里云交易和账单管理API提供的实例创建服务接口,创建DDoS高防实例。关于该接口的调用方式,请参见V3版本请求体&签名机制。
注意事项
-
调用CreateInstance接口创建DDoS高防实例后,会自动支付。实例的费用详情,请参见计费说明。
-
使用国际站账号创建DDoS高防实例时,账号必须开通信控身份。如未开通信控身份,请联系商务经理申请开通。
创建DDoS高防(中国内地)实例
您在调用CreateInstance接口创建DDoS高防(中国内地)实例时,需要完成以下API请求参数设置。
关于调用该接口所需的公共请求参数,请参见签名机制。
表 1. 请求参数:创建DDoS高防(中国内地)实例
|
名称 |
类型 |
是否必选 |
示例值 |
描述 |
|
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对,完成下表描述的实例配置。
表 2. DDoS高防(中国内地)实例配置
|
配置项(Code) |
类型 |
示例值(Value) |
描述 |
|
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)取值不同。具体说明如下:
|
|
ServiceBandwidth |
Float |
100 |
业务带宽,单位:Mbps。 取值范围:100~20,000,必须是50的整数倍。 |
|
95BurstBandwidthMode |
String |
1 |
95弹性业务带宽计费模式。取值:
|
|
NormalQps |
Float |
3000 |
正常业务QPS。 取值范围:3000~100000,必须是100的整数倍。 |
|
95BurstQPSMode |
String |
0 |
95弹性QPS模式。取值:
|
|
FunctionVersion |
String |
0 |
功能套餐类型。取值:
|
|
DomainCount |
Float |
50 |
防护域名数。 取值范围:50~2000,必须是10的整数倍。 |
|
PortCount |
Float |
50 |
防护端口数。 取值范围:50~1500,必须是5的整数倍。 |
创建DDoS高防(非中国内地)实例
您在调用CreateInstance接口创建DDoS高防(非中国内地)实例时,需要完成以下API请求参数设置。
关于调用该接口所需的公共请求参数,请参见签名机制。
表 3. 请求参数:创建DDoS高防(非中国内地)实例
|
名称 |
类型 |
是否必选 |
示例值 |
描述 |
|
Action |
String |
是 |
CreateInstance |
要执行的操作。取值:CreateInstance。 |
|
ProductCode |
String |
是 |
ddos |
实例所属服务的代码。 取值:ddos,表示DDoS高防服务。 |
|
ProductType |
String |
是 |
ddosDip |
实例所属服务的类型。 取值:ddosDip,表示DDoS高防(非中国内地)服务。 |
|
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配对,表示第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对,完成下表描述的实例配置。
表 4. DDoS高防(非中国内地)实例配置
|
配置项(Code) |
类型 |
示例值(Value) |
描述 |
|
Region |
String |
ap-southeast-1 |
服务地域。取值:ap-southeast-1,表示非中国内地。 |
|
ProductPlan |
String |
0 |
实例类型。取值:
|
|
SecMitigation |
String |
1 |
高级防护次数,仅购买安全加速线路2.0即ProductPlan为19时需要传。取值:0、1、2、31(无限次)。 |
|
NormalBandwidth |
String |
100 |
业务带宽,单位:Mbps。
|
|
95BurstBandwidthMode |
String |
1 |
95弹性业务带宽计费模式。取值:
|
|
NormalQps |
Float |
500 |
业务QPS。
|
|
95BurstQPSMode |
String |
0 |
95弹性QPS模式。取值:
说明
ProductPlan为2(表示创建加速线路实例)时,无需配置该参数。 |
|
FunctionVersion |
Strinig |
0 |
功能套餐类型。取值:
说明
ProductPlan为2(表示创建加速线路实例)时,无需配置该参数。 |
|
DomainCount |
Float |
10 |
防护域名数。
|
|
PortCount |
Float |
5 |
防护端口数。
|
|
IpGeolocation |
String |
SG |
IP注册地。取值:
|
返回数据
|
名称 |
类型 |
示例值 |
描述 |
|
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 }
-