Querying Events of a Specified EIP¶

Functions¶

This API allows you to query events of a specified EIP in the last 24 hours. Events include cleaning and blackhole events, and the query delay is within five minutes.

URI¶

URI format
GET /v1/{project_id}/antiddos/{floating_ip_id}/logs
Note
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
User ID
floating_ip_id
Yes
String
ID corresponding to the EIP of a user

Parameter	Mandatory	Type	Description
project_id	Yes	String	User ID
floating_ip_id	Yes	String	ID corresponding to the EIP of a user

Request¶

**Table 1** Parameter description¶
Parameter	Mandatory	Type	Description
limit	No	Integer	Limit of number of returned results or the maximum number of returned results of a query. The value ranges from 1 to 100, and this parameter is used together with the offset parameter. If neither limit nor offset is used, query results of all ECSs are returned.
offset	No	Integer	Offset. This parameter is valid only when used together with the limit parameter.
sort_dir	No	String	Possible values: desc: indicates that query results are given and sorted by time in descending order. asc: indicates that query results are given and sorted by time in ascending order. The default value is desc.

Response¶

Parameter description
Name
Type
Description
total
Integer
Total number of EIPs
logs
Data structure
List of events

Name	Type	Description
total	Integer	Total number of EIPs
logs	Data structure	List of events

Data structure description of logs

Parameter	Mandatory	Type	Description
start_time	Yes	Long integer	Start time
end_time	Yes	Long integer	End time
status	Yes	Integer	Defense status, the possible value of which is one of the following: 1: indicates that traffic cleaning is underway. 2: indicates that traffic is discarded.
trigger_bps	Yes	Integer	Traffic at the triggering point
trigger_pps	Yes	Integer	Packet rate at the triggering point
trigger_http_pps	Yes	Integer	HTTP request rate at the triggering point

Example¶

Example request

GET /v1/67641fe6886f43fcb78edbbf0ad0b99f/antiddos/1df977c2-fdc6-4483-bc1c-ba46829f57b8/logs

Example response

{
   "total": 1,
   "logs": [
      {
         "start_time": 1473217200000,
         "end_time": 1473242400000,
         "status": 1,
         "trigger_bps": 51106,
         "trigger_pps": 2600,
         "trigger_http_pps": 3589
      }
   ]
}

Status Code¶

See Status Code.

last updated: 2024-04-23 00:26