调用API创建DDoS原生防护实例_DDoS防护(Anti-DDoS)-阿里云帮助中心

DDoS原生防护不提供创建实例的接口，您可以调用阿里云交易和账单管理API提供的CreateInstance接口来创建实例。本文介绍如何调用API创建DDoS原生防护2.0（包年包月）实例。

背景信息

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

您可以调用阿里云交易和账单管理API提供的CreateInstance - 实例创建服务接口，创建DDoS原生防护实例。关于该接口的调用方式，请参见V2版本RPC风格请求体&签名机制。

注意事项

仅支持通过API创建DDoS原生防护2.0（包年包月）实例，包含中小企业普惠版、企业版。
调用CreateInstance接口创建DDoS原生防护实例后，会自动支付。实例的费用详情，请参见原生防护2.0（包年包月）。
使用国际站账号创建DDoS原生防护实例时，账号必须开通信控身份。如未开通信控身份，请联系商务经理申请开通。

创建中小企业普惠版实例

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	CreateInstance	要执行的操作。取值：CreateInstance。
ProductCode	String	是	ddos	实例所属服务的代码。取值：ddos，表示DDoS防护服务。
ProductType	String	是	ddos_originpre_public_cn	实例所属服务的类型。取值： ddos_originpre_public_cn：表示DDoS原生防护中国站服务。 ddos_ddosbgp_public_intl：表示DDoS原生防护国际站服务。
SubscriptionType	String	是	Subscription	实例的计费方式。取值：Subscription，表示包年包月方式。
Period	Integer	是	1	购买时长，单位：月。取值：1、2、3、4、5、6、12、24、36。
RenewalStatus	String	否	ManualRenewal	实例的续费方式。取值： ManualRenewal（默认）：表示手动续费。 AutoRenewal：表示自动续费。
RenewPeriod	Integer	否	1	自动续费周期，单位：月。说明 RenewalStatus为AutoRenewal（表示开启自动续费）时，必须设置本参数。
ClientToken	String	否	123e4567-e89b-12d3-a456-42665544****	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多信息，请参见如何保证幂等性。说明如果不设置本参数，则系统自动使用API请求的RequestId作为ClientToken标识。
Parameter.N.Code	String	是	mitigation_analysis	Parameter.N.Code表示一个实例配置项，Parameter.N.Value表示该配置项的值。您通过设置Parameter.N.Code和Parameter.N.Value对，设置某类型实例配置。其中，N表示配置项的序号，例如Parameter.1.Code和Parameter.1.Value配对，表示第1项配置。
Parameter.N.Value	String	是	off

Parameter.N.Code和Parameter.N.Value配置说明。

配置项（Code）	类型	示例值（Value）	描述
edition	String	smb	防护套餐类型。取值：smb，表示中小企业普惠版。
internet_protocol	String	v4	网络协议类型。取值： v4：IPv4。 v6：IPv6。
ip_qty	Integer	3	防护的IP数量。取值：1~29。
mitigation_qty_monthly	String	2	防护模式。取值：2，表示保险模式（2次防护/月）。
coverage	String	1_region	防护的资产地域。取值：1_region，表示仅能防护一个地域下的资产。
clean_bandwidth	Integer	50	业务带宽，单位：Mbps。取值：50~1,000，必须是50的整数倍。
mitigation_analysis	String	off	是否开启防护日志。取值：off，表示不开启。说明中小企业普惠版不支持开启防护日志。

请求示例

{
        "ProductCode": "ddos",
        "ProductType": "ddos_originpre_public_cn", 
        "Parameter.1.Code": "edition", 
        "Parameter.1.Value": "smb",
        "Parameter.2.Code": "internet_protocol",
        "Parameter.2.Value": "v4",
        "Parameter.3.Code": "ip_qty", 
        "Parameter.3.Value": "3",
        "Parameter.4.Code": "mitigation_qty_monthly",
        "Parameter.4.Value": "2",
        "Parameter.5.Code": "coverage", 
        "Parameter.5.Value": "1_region", 
        "Parameter.6.Code": "clean_bandwidth", 
        "Parameter.6.Value": "50",
        "Parameter.7.Code": "mitigation_analysis", 
        "Parameter.7.Value": "off",
        "SubscriptionType": "Subscription",
        "Period": "1",
        "RenewalStatus": "AutoRenewal",
        "RenewPeriod": "1"
    }

返回示例

{
  "Message": "Successful!",
  "RequestId": "A09C6A09-D399-5075-98D8-0A2D341EAC69",
  "Data": {
    "InstanceId": "ddos_originpre_public_cn-j4g3yvg****",
    "OrderId": 24005131779****
  },
  "Code": "Success",
  "Success": true
}

创建企业版实例

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	CreateInstance	要执行的操作。取值：CreateInstance。
ProductCode	String	是	ddos	实例所属服务的代码。取值：ddos，表示DDoS防护服务。
ProductType	String	是	ddos_originpre_public_cn	实例所属服务的类型。取值： ddos_originpre_public_cn：表示DDoS原生防护中国站服务。 ddos_ddosbgp_public_intl：表示DDoS原生防护国际站服务。
SubscriptionType	String	是	Subscription	实例的计费方式。取值：Subscription，表示包年包月方式。
Period	Integer	是	1	购买时长，单位：月。取值：1、2、3、4、5、6、12、24、36。
RenewalStatus	String	否	ManualRenewal	实例的续费方式。取值： ManualRenewal（默认）：表示手动续费。 AutoRenewal：表示自动续费。
RenewPeriod	Integer	否	1	自动续费周期，单位：月。说明 RenewalStatus为AutoRenewal（表示开启自动续费）时，必须设置本参数。
ClientToken	String	否	123e4567-e89b-12d3-a456-42665544****	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多信息，请参见如何保证幂等性。说明如果不设置本参数，则系统自动使用API请求的RequestId作为ClientToken标识。
Parameter.N.Code	String	是	mitigation_analysis	Parameter.N.Code表示一个实例配置项，Parameter.N.Value表示该配置项的值。您通过设置Parameter.N.Code和Parameter.N.Value对，设置某类型实例配置。其中，N表示配置项的序号，例如Parameter.1.Code和Parameter.1.Value配对，表示第1项配置。
Parameter.N.Value	String	是	off

Parameter.N.Code和Parameter.N.Value配置说明。

配置项（Code）	类型	示例值（Value）	描述
edition	String	enterprise	防护套餐类型。取值：enterprise，表示企业版。
internet_protocol	String	v4_6	网络协议类型。取值：v4_6，表示支持IPv4和IPv6。
ip_qty	Integer	30	防护的IP数量。取值：30~10,000,000。
mitigation_qty_monthly	String	unlimited	防护模式。取值： 2：表示保险模式（2次防护/月）。 unlimited：表示无忧模式（不限次/月）。说明中国站用户本参数仅支持设置为2，国际站用户所有取值都支持。
coverage	String	only_mainland_china	防护的资产地域。取值： only_mainland_china：中国内地多地域。 international_and_hmt：非中国内地多地域。 global：全球。说明中国站用户本参数仅支持设置为only_mainland_china，国际站用户所有取值都支持。
clean_bandwidth	Integer	100	业务带宽，单位：Mbps。取值：100~900,000，必须是100的整数倍。
mitigation_analysis	String	on	是否开启防护日志。取值： on：开启 off：关闭
mitigation_analysis_capacity	String	3T	日志容量。取值：仅支持设置为3T，表示日志容量为3 TB。说明 mitigation_analysis取值为on时，必须配置本参数。

请求示例

{
        "ProductCode": "ddos",
        "ProductType": "ddos_originpre_public_cn",
        "Parameter.1.Code": "edition",
        "Parameter.1.Value": "enterprise",
        "Parameter.2.Code": "internet_protocol",
        "Parameter.2.Value": "v4_6",
        "Parameter.3.Code": "ip_qty",
        "Parameter.3.Value": "30",
        "Parameter.4.Code": "mitigation_qty_monthly",
        "Parameter.4.Value": "unlimited",
        "Parameter.5.Code": "coverage",
        "Parameter.5.Value": "only_mainland_china", 
        "Parameter.6.Code": "clean_bandwidth",
        "Parameter.6.Value": "100",
        "Parameter.7.Code": "mitigation_analysis",
        "Parameter.7.Value": "on", 
        "Parameter.8.Code": "mitigation_analysis_capacity",
        "Parameter.8.Value": "3T",
        "SubscriptionType": "Subscription",
        "Period": "1",
        "RenewalStatus": "AutoRenewal",
        "RenewPeriod": "1"

    }

返回示例

{
  "Message": "Successful!",
  "RequestId": "09B48D51-AD06-5D95-8C0A-4BCD2E406F0C",
  "Data": {
    "InstanceId": "ddos_originpre_public_cn-lf63yvl****",
    "OrderId": 24005235006****
  },
  "Code": "Success",
  "Success": true
}