All Products
Search
Document Center

Cloud Firewall:DescribeInternetDropTrafficTrend

Last Updated:Oct 16, 2025

Trends in internet security.

Operation description

QPS limit

This operation supports up to 10 queries per second (QPS) for each user. If you exceed the limit, your API calls are throttled. Throttling may affect your business. We recommend that you call this operation at a reasonable rate.

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

SourceIp

string

No

The source IP address.

120.136.21.XXX

Lang

string

No

The language of the response.

Valid values:

  • en :

    English

  • zh :

    Chinese

zh

Lang

string

No

The language of the response.

Valid values:

  • en :

    English

  • zh :

    Chinese

zh

Direction

string

No

The direction.

Valid values:

  • in :

    inbound

  • out :

    outbound

out

StartTime

string

Yes

The start time. Use a UNIX timestamp. Unit: seconds.

1749176793

EndTime

string

Yes

The end time. Use a UNIX timestamp. Unit: seconds.

1756346821

SourceCode

string

Yes

The source tracking code.

yundun

Response elements

Element

Type

Description

Example

object

DropSessionMax

integer

The peak number of dropped sessions during the specified period.

8090

RingRatioAverage

string

The average traffic rate. Unit: percent.

1.23

RequestId

string

The request ID.

F0F82705-CFC7-5F83-86C8-A063892F****

RatioAverage

string

The traffic distribution pattern. A value of 0 indicates the priority pattern and a value of 1 indicates the load balancing pattern.

12.34

DataList

array<object>

The data list.

object

The data list.

Time

integer

The timestamp.

1659405600

AclDrop

integer

The number of intrusion prevention events.

12

DropRatio

string

The traffic data points.

1

RingDataTime

string

The time point in the previous epoch.

2018-08-25 12:00:00

IpsDrop

integer

The number of IP addresses.

5

TotalSession

integer

The total number of requests.

10

DataTime

string

The current time point.

2018-08-25 12:00:00

DropSession

integer

The number of dropped sessions.

12

RingTime

integer

The dynamic packet loss time.

1724982259

DropRing

integer

The value. Valid values: [0, 10000].

0

DropRingRatio

string

The network traffic rate, measured in kbps.

1

Examples

Success response

JSON format

{
  "DropSessionMax": 8090,
  "RingRatioAverage": "1.23",
  "RequestId": "F0F82705-CFC7-5F83-86C8-A063892F****",
  "RatioAverage": "12.34",
  "DataList": [
    {
      "Time": 1659405600,
      "AclDrop": 12,
      "DropRatio": "1",
      "RingDataTime": "2018-08-25 12:00:00",
      "IpsDrop": 5,
      "TotalSession": 10,
      "DataTime": "2018-08-25 12:00:00",
      "DropSession": 12,
      "RingTime": 1724982259,
      "DropRing": 0,
      "DropRingRatio": "1"
    }
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 ErrorAliUid Aliuid invalid. The aliuid is invalid.
400 ErrorDirectionError The direction is invalid. The direction is invalid.
400 ErrorIntervalError The interval is invalid. The interval is invalid.
400 ErrorTimeError The time is invalid. The time is invalid.
400 ErrorMarshalJSON internal error. Internal error.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.