文档首页> DDoS防护 AAD> API参考> API> DDoS防护管理> 查询EIP防护状态列表
更新时间:2023-06-19 GMT+08:00

查询EIP防护状态列表

功能介绍

查询用户所有EIP的Anti-DDoS防护状态信息,用户的EIP无论是否绑定到云服务器,都可以进行查询。

URI

GET /v1/{project_id}/antiddos

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id

最小长度:32

最大长度:64

表2 Query参数

参数

是否必选

参数类型

描述

status

String

可选范围:

  • normal:表示正常

  • configging:表示设置中

  • notConfig:表示未设置

  • packetcleaning:表示清洗

  • packetdropping:表示黑洞

不带此参数默认所有列表,以neutron查询到的顺序为准。

limit

String

返回结果个数限制,取值范围:1~100

offset

String

偏移量,取值范围:0~2147483647

ip

String

IP地址,支持IPv4格式和IPv6格式输入,支持部分查询。例如“?ip=192.168”,会返回192.168.111.1和10.192.168.8所对应的EIP防护状态。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

最小长度:32

最大长度:2097152

Content-Type

String

Content-Type请求头

缺省值:application/json;charset=utf8

最小长度:1

最大长度:255

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

total

Integer

弹性IP总数

ddosStatus

Array of DDosStatus objects

防护状态列表

表5 DDosStatus

参数

参数类型

描述

floating_ip_id

String

EIP的ID

floating_ip_address

String

浮动IP地址

network_type

String

EIP所属类型,可选范围:

  • EIP:未绑定到ECS的EIP或绑定到ECS的EIP

  • ELB:绑定到ELB的EIP

status

String

防护状态,可选范围:

  • normal:表示正常

  • configging:表示设置中

  • notConfig:表示未设置

  • packetcleaning:表示清洗

  • packetdropping:表示黑洞

blackhole_endtime

Long

黑洞结束时间

protect_type

String

防护类型

traffic_threshold

Long

流量阈值

http_threshold

Long

http流量阈值

请求示例

响应示例

状态码: 200

请求已成功

{
  "total" : 1,
  "ddosStatus" : [ {
    "floating_ip_id" : "18e6ace5-eb36-4196-a15e-1e000c24e026",
    "floating_ip_address" : "139.9.116.167",
    "network_type" : "EIP",
    "status" : "normal",
    "blackhole_endtime" : 0,
    "protect_type" : "default",
    "traffic_threshold" : 99,
    "http_threshold" : 0
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码