Queries the traffic statistics of users under a Smart Access Gateway (SAG) APP instance.


Use OpenAPI Explorer to perform debug operations and generate SDK code examples.

Request parameters

Parameter Type Required? Example value Description
RegionId String Yes cn-hangzhou

The ID of the region to which the SAG APP instance belongs.

SmartAGId String Yes sag-mfkg*****

The ID of the SAG APP instance.

UserNames.N RepeatList Yes 12

The list of users. Maximum value: 50.

Action String No DescribeUserFlowStatistics

The name of this action.

Value: DescribeUserOnlineClients

StatisticsDate String No 201905

The month in which the data is collected. Format: yyyyMM.

If you do not specify this parameter, the data of the current month is collected by default.

Response parameters

Parameter Type Example value Description
RequestId String 9552AD68-18EA-4074-B27D-40040FBA9683

The ID of the request.


The traffic statistics.

TotalBytes String 12

The traffic amount. Unit: Bytes.

UserName String doctest

The name of the user.


Request example

http(s)://[Endpoint]/? Action=DescribeUserFlowStatistics
&UserNames. 1=12

Response example

XML format


JSON format



HTTP status code Error code Error message Description
400 SAG.InstanceIdEmpty You must specify the SAG instance ID. The ID of the SAG instance is empty.
400 SAG.InstanceNoFound The specified SAG instance does not exist. The specified SAG instance does not exist.

For a list of error codes, visit the API Error Center.