文档首页/ DDoS防护 AAD/ API参考（安卡拉区域）/ API/ Anti-DDoS API接口/ 查询EIP防护状态列表
更新时间：2024-04-19 GMT+08:00
查看PDF
分享

查询EIP防护状态列表

功能介绍

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

URI

  • URI格式

    GET /v1/{project_id}/antiddos

    可以在URI后面用“?”和“&”添加不同的查询条件组合，请参考请求样例。

  • 参数说明

    参数

    是否必选

    类型

    说明

    project_id

    是

    String

    用户的ID

请求消息

表1 请求参数

参数

是否必选

类型

说明

status

否

String
可选范围：
  • normal：表示正常
  • configging：表示设置中
  • notConfig：表示未设置
  • packetcleaning：表示清洗
  • packetdropping：表示黑洞

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

limit

否

Integer

返回结果个数限制，取值范围：1~100

offset

否

Integer

偏移量，取值范围：0~2147483647

ip

否

String

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

响应消息

  • 要素说明

    名称

    类型

    说明

    total

    Integer

    弹性IP总数

    ddosStatus

    列表数据结构

    防护状态列表
  • ddosStatus字段数据结构说明

    参数

    是否必选

    类型

    说明

    floating_ip_address

    是

    String

    浮动IP地址

    floating_ip_id

    是

    String

    EIP的ID

    network_type

    是

    String

    EIP所属类型，可选范围：

    • EIP：未绑定到ECS的EIP或绑定到ECS的EIP
    • ELB：绑定到ELB的EIP

    status

    是

    String
    防护状态，可选范围：
    • normal：表示正常
    • configging：表示设置中
    • notConfig：表示未设置
    • packetcleaning：表示清洗
    • packetdropping：表示黑洞

示例

  • 请求示例 
    GET /v1/67641fe6886f43fcb78edbbf0ad0b99f/antiddos?status=packetdropping
  • 响应示例 
    {
   "total": 5,
   "ddosStatus": [
      {
         "floating_ip_id": "1867f954-fc11-4202-8247-6af2144867ea",
         "floating_ip_address": "192.168.42.221",
         "network_type": "EIP",
         "status": "notConfig"
      },
      {
         "floating_ip_id": "49c6af49-9ace-42e6-ab89-1eee1f4ac821",
         "floating_ip_address": "192.168.35.152",
         "network_type": "EIP",
         "status": "normal"
      },
      {
         "floating_ip_id": "7a8dc957-083b-499d-b7cf-6fa48f4880c5",
         "floating_ip_address": "192.168.42.222",
         "network_type": "EIP",
         "status": "notConfig"
      },
      {
         "floating_ip_id": "7c6676a0-b281-4163-9d0d-cb6485ae9860",
         "floating_ip_address": "192.168.44.69",
         "network_type": "EIP",
         "status": "normal"
      },
      {
         "floating_ip_id": "969c1d48-6a92-4ef1-b66c-b17c7e7d7ce7",
         "floating_ip_address": "192.168.47.192",
         "network_type": "EIP",
         "status": "notConfig"
      }
   ]
}

返回值

请参考状态码。

父主题： Anti-DDoS API接口