DDoS防护服务不提供创建实例的接口。您可以通过调用阿里云交易和账单管理API提供的CreateInstance接口来创建DDoS高防（新BGP、国际）实例。

背景信息

阿里云交易和账单管理API是一套通用的管理阿里云资源的接口，可以用于查询服务价格、管理实例、获取账单信息等。关于阿里云交易和账单管理API支持的所有接口，请参见API概览。

您可以调用阿里云交易和账单管理API提供的CreateInstance接口，创建DDoS高防（新BGP、国际）实例。关于该接口的调用方式，请参见请求结构。

下文介绍了调用CreateInstance接口创建DDoS高防（新BGP）实例、DDoS高防（国际）实例的请求方法和示例。

创建DDoS高防（新BGP）实例

您在调用CreateInstance接口创建DDoS高防（新BGP）实例时，需要完成以下API请求参数设置。
说明 关于调用该接口所需的公共请求参数，请参见公共参数。
表 1. 请求参数：创建DDoS高防（新BGP）实例
名称 类型 是否必选 示例值 描述
Action String 是 CreateInstance 要执行的操作。取值：CreateInstance。
ProductCode String 是 ddos 实例所属服务的代码。

取值：ddos，表示DDoS高防服务。

ProductType String 是 ddoscoo 实例所属服务的类型。

取值：ddoscoo，表示DDoS高防（新BGP）服务。

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高防（新BGP）实例的具体配置，请参见DDoS高防（新BGP）实例配置。

Parameter.N.Value String 是 0
RenewalStatus String 否 ManualRenewal 实例的续费方式。取值：
  • ManualRenewal（默认）：表示手动续费。
  • AutoRenewal：表示自动续费。
RenewPeriod Integer 否 1 自动续费周期， 单位：月。
说明 RenewalStatus为AutoRenewal（表示开启自动续费）时，必须设置该参数。
ClientToken String 否 123e4567-e89b-12d3-a456-42665544**** 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多信息，请参见如何保证幂等性。
说明 如果不设置该参数，则系统自动使用API请求的RequestId作为ClientToken标识。
创建DDoS高防（新BGP）实例时，您需要通过Parameter.N.Code和Parameter.N.Value对，完成下表描述的实例配置。
表 2. DDoS高防（新BGP）实例配置
配置项（Code） 类型 示例值（Value） 描述
Edition String coop 防护套餐类型。取值：coop，表示专业版。
FunctionVersion String 0 功能套餐类型。取值：
  • 0：表示标准功能。
  • 1：表示增强功能。
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 保底防护带宽，单位：GB。

取值：30、60、100、300、400、500、600。
Bandwidth Float 50 弹性防护带宽，单位：GB。
弹性防护带宽必须大于或等于保底防护带宽。不同保底防护带宽（BaseBandwidth）支持的弹性防护带宽（Bandwidth）取值不同。具体说明如下：
  • BaseBandwidth为30时，Bandwidth取值：30、40、50、60、70、80、100、150、200、300。
  • BaseBandwidth为60时，Bandwidth取值：60、70、80、100、150、200、300、400、500、600。
  • BaseBandwidth为100时，Bandwidth取值：100、150、200、300、400、500、600。
  • BaseBandwidth为300时，Bandwidth取值：300、400、500、600。
  • BaseBandwidth为400时，Bandwidth取值：400、500、600。
  • BaseBandwidth为500时，Bandwidth取值：500、600。
  • BaseBandwidth为600时，Bandwidth取值：600。
ServicePartner String coop-line-001 防护线路类型。取值：coop-line-001，表示默认防护线路。
95BurstBandwidthMode String 1 95弹性业务带宽计费模式。取值：
  • 0：表示不启用弹性业务带宽。
  • 1：表示启用弹性业务带宽，计费模式为日95模式。
  • 2：表示启用弹性业务带宽，计费模式为月95模式。
AddressType String Ipv4 IP地址的协议类型。取值：
  • Ipv4：表示IPv4协议。
  • Ipv6：表示IPv6协议。

创建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 购买时长，单位：月。

取值：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 实例的续费方式。取值：
  • ManualRenewal（默认）：表示手动续费。
  • AutoRenewal：表示自动续费。
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 实例类型。取值：
  • 0：表示保险版实例。
  • 1：表示无忧版实例。
  • 2：表示加速线路实例。
  • 3：表示安全加速线路实例。
FunctionVersion Strinig 0 功能套餐类型。取值：
  • 0：表示标准功能。
  • 1：表示增强功能。
说明 ProductPlan为2（表示创建加速线路实例）时，无需配置该参数。
NormalQps Float 500 业务QPS。
不同实例类型（ProductPlan）支持的业务QPS（NormalQps）取值范围不同。具体说明如下：
  • ProductPlan为0时，NormalQps取值范围：500~100000，必须是100的整数倍。
  • ProductPlan为1时，NormalQps取值范围：1000~100000，必须是100的整数倍。
  • ProductPlan为2时，无需配置该参数。
  • ProductPlan为3时，NormalQps取值范围：500~100000，必须是100的整数倍。
NormalBandwidth String 100 业务带宽，单位：Mbps。
不同实例类型（ProductPlan）支持的业务带宽（NormalBandwidth）取值不同。具体说明如下：
  • ProductPlan为0时，NormalBandwidth取值：100、150、200、250、300。
  • ProductPlan为1时，NormalBandwidth取值：100、150、200、250、300。
  • ProductPlan为2时，NormalBandwidth取值：10、20、30、40、50、60、70、80、90、100。
  • ProductPlan为3时，NormalBandwidth取值：10、20、30、40、50、60、70、80、90、100、150、200。
PortCount Float 5 防护端口数。
不同实例类型（ProductPlan）支持的防护端口数（PortCount）取值范围不同。具体说明如下：
  • ProductPlan为0时，PortCount取值范围：5~400，必须是5的整数倍。
  • ProductPlan为1时，PortCount取值范围：5~400，必须是5的整数倍。
  • ProductPlan为2时，无需配置PortCount。
  • ProductPlan为3时，PortCount取值范围：5~400，必须是5的整数倍。
DomainCount Float 10 防护域名数。
不同实例类型（ProductPlan）支持的防护域名数（DomainCount）取值范围不同。具体说明如下：
  • ProductPlan为0时，DomainCount取值范围：10~200，必须是10的整数倍。
  • ProductPlan为1时，DomainCount取值范围：10~200，必须是10的整数倍。
  • ProductPlan为2时，无需配置DomainCount。
  • ProductPlan为3时，DomainCount取值范围：10~200，必须是10的整数倍。
95BurstBandwidthMode String 1 95弹性业务带宽计费模式。取值：
  • 0：表示不启用弹性业务带宽。
  • 1：表示启用弹性业务带宽，计费模式为日95模式。
  • 2：表示启用弹性业务带宽，计费模式为月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 本次请求是否成功。取值：
  • true：表示请求成功。
  • false：表示请求失败。

示例

  • 示例1：创建DDoS高防（新BGP）实例
    请求示例
    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
}