Help Center/ Anti-DDoS/ API Reference/ API/ DDoS Protection Management/ Querying Events of a Specified EIP

Updated on 2025-10-09 GMT+08:00

View PDF

Querying Events of a Specified EIP

Function

This API allows you to query events of a specified EIP in the last 24 hours. Events include cleaning and black hole events. The query delay is no more than 5 minutes.

Calling Method

For details, see Calling APIs.

URI

GET /v1/{project_id}/antiddos/{floating_ip_id}/logs

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID.
floating_ip_id	Yes	String	ID corresponding to the EIP of a user.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
sort_dir	No	String	Values: desc: descending order of time asc: ascending order of time The default value is desc.
limit	No	String	Maximum number of returned results. The value ranges from 1 to 100. This parameter is used together with offset. If neither limit nor offset is specified, all servers are returned.
offset	No	String	Offset. This field is valid only if limit is specified.
ip	No	String	EIP of a user.

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.
Content-Type	Yes	String	Content-Type request header.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
total	Long	Total number of EIPs.
logs	Array of DailyLog objects	Abnormal event list.

**Table 5** DailyLog
Parameter	Type	Description
start_time	Long	Start time.
end_time	Long	End time.
status	Integer	Protection status. The options are as follows: 1: cleaning 2: blackhole
trigger_bps	Integer	Traffic at the triggering point.
trigger_pps	Integer	Packet rate at the triggering point.
trigger_http_pps	Integer	HTTP request rate at the triggering point.