文档首页/ Anti-DDoS流量清洗 Anti-DDoS/ API参考（安卡拉区域）/ API/ Anti-DDoS API接口/ 开通Anti-DDoS服务
更新时间：2024-04-12 GMT+08:00
查看PDF
分享

开通Anti-DDoS服务

功能介绍

用户开通Anti-DDoS流量清洗防护。作为异步接口，调用成功，只是说明服务节点收到了开通请求，开通是否成功需要通过任务查询接口查询该任务的执行状态，具体请参考查询Anti-DDoS任务。

URI

  • URI格式

    POST /v1/{project_id}/antiddos/{floating_ip_id}

  • 参数说明

    参数

    是否必选

    类型

    说明

    project_id

    是

    String

    用户的ID

    floating_ip_id

    是

    String

    用户EIP对应的ID

请求消息

表1 请求参数

参数

是否必选

类型

说明

enable_L7

否

Boolean

是否开启L7层防护

traffic_pos_id

是

Integer

流量分段ID，取值范围：1～9

http_request_pos_id

是

Integer

HTTP请求数分段ID，取值范围：1～15

cleaning_access_pos_id

是

Integer

清洗时访问限制分段ID，取值范围：1～8

app_type_id

否

Integer
应用类型ID，可选取值：
  • 0
  • 1

响应消息

表2 响应参数

名称

类型

说明

error_code

String

内部错误码

error_description

String

内部错误描述

task_id

String

任务ID，后续可根据该ID查询本任务状态。

本字段为后续的任务审计扩展，暂时不需要，先保留。

示例

  • 请求示例 
    POST /v1/67641fe6886f43fcb78edbbf0ad0b99f/antiddos/1df977c2-fdc6-4483-bc1c-ba46829f57b8 
    {
    "enable_L7":true,
    "traffic_pos_id":1,
    "http_request_pos_id":1,
    "cleaning_access_pos_id":1,
    "app_type_id":1
}
  • 响应示例 
    {
   "error_code": "10000000",
   "error_description": "Task has been received and is being processed.",
   "task_id": "94e17e18-5b2c-40c6-a218-8ec5134e32a5"
}

返回值

请参考状态码。

父主题： Anti-DDoS API接口