更新时间:2024-04-19 GMT+08:00

查询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"
          }
       ]
    }

返回值

请参考状态码