更新时间:2025-06-09 GMT+08:00
分享

查询用户EIP防护状态列表

功能介绍

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

调用方法

请参见如何调用API

URI

GET /v2/{project_id}/antiddos

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id

表2 Query参数

参数

是否必选

参数类型

描述

status

String

可选范围:

  • normal:表示正常

  • configging:表示设置中

  • notConfig:表示未设置

  • packetcleaning:表示清洗

  • packetdropping:表示黑洞

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

limit

String

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

offset

String

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

ips

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的值)。

Content-Type

String

Content-Type请求头

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

total

Integer

弹性IP总数

ddosStatus

Array of EipDDosStatus objects

防护状态列表

表5 EipDDosStatus

参数

参数类型

描述

floating_ip_id

String

EIP的ID

floating_ip_address

String

浮动IP地址

product_type

String

EIP所属类型,可选范围:

  • Anti-DDoS:eip属于Anti-DDoS流量清洗

  • CNAD:eip属于DDoS原生高级防护

status

String

防护状态,可选范围:

  • normal:表示正常

  • configging:表示设置中

  • notConfig:表示未设置

  • packetcleaning:表示清洗

  • packetdropping:表示黑洞

clean_threshold

Long

清洗阈值

block_threshold

String

黑洞阈值

请求示例

响应示例

状态码:200

请求已成功

{
  "total" : 2,
  "ddosStatus" : [ {
    "floating_ip_id" : "xxxxxxxx-xxxx-4947-9fa8-dda843ae5d1d",
    "floating_ip_address" : "10.10.10.10",
    "status" : "normal",
    "product_type" : "CNAD",
    "clean_threshold" : 1000,
    "block_threshold" : ">=20Gbps"
  }, {
    "floating_ip_id" : "xxxxxxxx-xxxx-4d33-a2dc-2ace2d0283de",
    "floating_ip_address" : "11.11.11.11",
    "status" : "normal",
    "product_type" : "Anti-DDoS",
    "clean_threshold" : 120,
    "block_threshold" : ">=20Gbps"
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档