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 购买时长,单位:月。

取值:1234561224

Parameter.N.Code String FunctionVersion Parameter.N.Code表示一个实例配置项,Parameter.N.Value表示该配置项的值。

您通过设置Parameter.N.CodeParameter.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 自动续费周期, 单位:月。
注意 RenewalStatusAutoRenewal(表示开启自动续费)时,必须设置该参数。
ClientToken String 123e4567-e89b-12d3-a456-42665544**** 保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性
说明 如果不设置该参数,则系统自动使用API请求的RequestId作为ClientToken标识。
创建DDoS高防(新BGP)实例时,您需要通过Parameter.N.CodeParameter.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,表示默认防护线路。

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

取值:361224

Parameter.N.Code String FunctionVersion Parameter.N.Code表示一个实例配置项,Parameter.N.Value表示该配置项的值。

您通过设置Parameter.N.CodeParameter.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 自动续费周期, 单位:月。
说明 RenewalStatusAutoRenewal(表示开启自动续费)时,必须设置该参数。
ClientToken String 123e4567-e89b-12d3-a456-42665544**** 保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性
说明 如果不设置该参数,则系统自动使用API请求的RequestId作为ClientToken标识。
创建DDoS高防(国际)实例时,您需要通过Parameter.N.CodeParameter.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的整数倍。

返回数据

名称 类型 示例值 描述
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'
    &<公共请求参数>
    正常返回示例
    • 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
    &<公共请求参数>
    正常返回示例
    • 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
    &<公共请求参数>
    正常返回示例
    • 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
      }