Querying Events of a Specified EIP

Updated on 2022-02-22 GMT+08:00

View PDF

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

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

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