Querying the List of Defense Statuses of EIPs

Functions

This API enables you to query the defense statuses of all EIPs, regardless whether an EIP has been bound to an Elastic Cloud Server (ECS) or not.

URI

URI format
GET /v1/{project_id}/antiddos

You can use ? and & behind the URI to add query conditions, as shown in the request example.

Parameter description

Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID.

Request

**Table 1** Parameter description
Parameter	Mandatory	Type	Description
status	No	String	Possible values: normal: indicates that the defense status is normal. configuring: indicates that defense is being configured. notConfig: indicates that defense is not configured. packetcleaning: indicates that traffic cleaning is underway. packetdropping: indicates that traffic is discarded. If this parameter is not used, the defense statuses of all ECSs are displayed in the Neutron-queried order by default.
limit	No	Integer	Maximum number of returned results. The value ranges from 1 to 100.
offset	No	Integer	Offset. The value ranges from 0 to 2147483647.
ip	No	String	IP address. Both IPv4 and IPv6 addresses are supported. For example, if you enter ?ip=192.168, the defense status of EIPs corresponding to 192.168.111.1 and 10.192.168.8 is returned.

Response

Parameter description

Name	Type	Description
total	Integer	Total number of EIPs
ddosStatus	List data structure	List of protection statuses

Data structure description of ddosStatus

Parameter	Type	Description
floating_ip_address	String	Floating IP address
floating_ip_id	String	ID of an EIP
network_type	String	EIP type. The value can be: EIP: EIP that is bound or not bound with ECS. ELB: EIP that is bound with ELB.
status	String	Defense status, the possible value of which is one of the following: normal: indicates that the defense status is normal. configuring: indicates that defense is being configured. notConfig: indicates that defense is not configured. packetcleaning: indicates that traffic cleaning is underway. packetdropping: indicates that traffic is discarded.
blackhole_endtime	Integer	End time of a black hole.
protect_type	String	Protection type
traffic_threshold	Integer	Traffic threshold
http_threshold	Integer	HTTP traffic threshold.

Example

Example request

GET /v1/67641fe6886f43fcb78edbbf0ad0b99f/antiddos?status=packetdropping

Example response

{
    "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
        }
    ]
}