更新时间:2024-07-09 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:表示黑洞。

    blackhole_endtime

    Integer

    黑洞结束时间。

    protect_type

    String

    防护类型。

    traffic_threshold

    Integer

    流量阈值。

    http_threshold

    Integer

    http流量阈值。

示例

  • 请求示例
    GET /v1/67641fe6886f43fcb78edbbf0ad0b99f/antiddos?status=packetdropping 
  • 响应示例
    {
        "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
            }
        ]
    }

返回值

请参考状态码