All Products
Search
Document Center

Cloud Firewall:DescribeFirewallDropTrend

Last Updated:Jun 23, 2026

Retrieves the overall firewall interception trend, including Internet, VPC, and NAT traffic.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

Lang

string

No

The language of the response. Valid values:

  • zh (default): Chinese

  • en: English.

zh

StartTime

integer

No

The start time of the query. Specify the value as a UNIX timestamp in seconds.

1758470400

EndTime

integer

No

The end time of the query. Specify the value as a UNIX timestamp in seconds.

1758474000

Response elements

Element

Type

Description

Example

object

MaxDropSession

integer

The maximum number of total blocked sessions.

300

MaxDropTime

integer

The time when the maximum number of total blocked sessions occurred. The value is a UNIX timestamp in seconds, such as 1672502400.

1656837360

RequestId

string

The request ID.

75E60025-43C5-5635-B7B7-272C5246****

DataList

array<object>

The returned data list.

object

The returned data list.

TotalDropSession

integer

The total number of sessions blocked by the firewall.

300

NatDropSession

integer

The number of sessions blocked by the NAT firewall.

100

VpcDropSession

integer

The number of sessions blocked by the VPC firewall.

100

Time

integer

The time when the traffic occurred. The value is a UNIX timestamp in seconds.

If the data at this point in time has not been processed, the values of all other fields are -1.

1758474000

InternetDropSession

integer

The number of sessions blocked by the Internet firewall.

100

Examples

Success response

JSON format

{
  "MaxDropSession": 300,
  "MaxDropTime": 1656837360,
  "RequestId": "75E60025-43C5-5635-B7B7-272C5246****",
  "DataList": [
    {
      "TotalDropSession": 300,
      "NatDropSession": 100,
      "VpcDropSession": 100,
      "Time": 1758474000,
      "InternetDropSession": 100
    }
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 ErrorAliUid Aliuid invalid. The aliuid is invalid.
400 ErrorIntervalError The interval is invalid. The interval is invalid.
400 ErrorTimeError The time is invalid. The time is invalid.
400 ErrorDBSelectError A database select error occurred. The error message returned because an internal error has occurred in querying the database.
400 ErrorMarshalJSON internal error. Internal error.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.