Help Center/ Anti-DDoS/ API Reference/ API/ DDoS Protection Management/ Querying Weekly Defense Statistics

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

View PDF

Querying Weekly Defense Statistics

Function

This API allows you to query weekly defense statistics about all your EIPs, including the number of blocked DDoS attacks, number of attacks, and ranking by the number of attacks. Currently, you can query weekly statistics up to four weeks before the current time. Data older than four weeks cannot be queried.

Calling Method

For details, see Calling APIs.

URI

GET /v1/{project_id}/antiddos/weekly

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
period_start_date	No	String	Start date of a week.

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
ddos_intercept_times	Integer	Number of DDoS attacks blocked in a week.
weekdata	Array of WeeklyCount objects	Number of attacks in a week.
top10	Array of WeeklyTop10 objects	Top 10 attacked IP addresses.

**Table 5** WeeklyCount
Parameter	Type	Description
ddos_intercept_times	Integer	Number of DDoS attacks blocked.
ddos_blackhole_times	Integer	Number of DDoS black holes.
max_attack_bps	Integer	Maximum attack traffic.
max_attack_conns	Integer	Maximum number of attack connections.
period_start_date	Long	Start time.

**Table 6** WeeklyTop10
Parameter	Type	Description
floating_ip_address	String	EIP.
times	Integer	Number of DDoS attacks blocked by cleaning operations and black holes.

Example Requests

None

Example Responses

Status code: 200

Request succeeded.

{
  "ddos_intercept_times" : 0,
  "weekdata" : [ {
    "ddos_intercept_times" : 0,
    "ddos_blackhole_times" : 0,
    "max_attack_bps" : 0,
    "max_attack_conns" : 0,
    "period_start_date" : 1605496722606
  }, {
    "ddos_intercept_times" : 0,
    "ddos_blackhole_times" : 0,
    "max_attack_bps" : 0,
    "max_attack_conns" : 0,
    "period_start_date" : 1605583122606
  }, {
    "ddos_intercept_times" : 0,
    "ddos_blackhole_times" : 0,
    "max_attack_bps" : 0,
    "max_attack_conns" : 0,
    "period_start_date" : 1605669522606
  }, {
    "ddos_intercept_times" : 0,
    "ddos_blackhole_times" : 0,
    "max_attack_bps" : 0,
    "max_attack_conns" : 0,
    "period_start_date" : 1605755922606
  }, {
    "ddos_intercept_times" : 0,
    "ddos_blackhole_times" : 0,
    "max_attack_bps" : 0,
    "max_attack_conns" : 0,
    "period_start_date" : 1605842322606
  }, {
    "ddos_intercept_times" : 0,
    "ddos_blackhole_times" : 0,
    "max_attack_bps" : 0,
    "max_attack_conns" : 0,
    "period_start_date" : 1605928722606
  }, {
    "ddos_intercept_times" : 0,
    "ddos_blackhole_times" : 0,
    "max_attack_bps" : 0,
    "max_attack_conns" : 0,
    "period_start_date" : 1606015122606
  } ],
  "top10" : [ ]
}