调用DescribeUserOnlineClients查询指定智能接入网关APP实例下用户的流量统计。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String cn-hangzhou

智能接入网关APP实例所在的地域。

SmartAGId String sag-mfkg*****

智能接入网关APP实例ID。

UserNames.N RepeatList 12

用户名列表,最大50。

Action String DescribeUserFlowStatistics

要执行的操作。

取值:DescribeUserOnlineClients

StatisticsDate String 201905

统计日期,格式yyyyMM。

如果不设置,默认表示当月。

返回数据

名称 类型 示例值 描述
RequestId String 9552AD68-18EA-4074-B27D-40040FBA9683

请求ID。

SagStatistics

流量统计。

TotalBytes String 12

流量值,单位byte。

UserName String doctest

用户名。

示例

请求示例


http(s)://[Endpoint]/?Action=DescribeUserFlowStatistics
&RegionId=cn-hangzhou
&SmartAGId=sag-mfkg*****
&UserNames.1=12
&<公共请求参数>

正常返回示例

XML 格式

<DescribeUserFlowStatisticsResponse>
      <SagStatistics>
		    <Statistics>
			      <UserName>zhanlg</UserName>
			      <TotalBytes>555352</TotalBytes>
		    </Statistics>
	  </SagStatistics>
	  <RequestId>ADD09081-31A9-4E7D-B15C-135C6EBEEB63</RequestId>
    </DescribeUserFlowStatisticsResponse>

JSON 格式

{
	"RequestId":"ADD09081-31A9-4E7D-B15C-135C6EBEEB63",
	"SagStatistics":{
		"Statistics":[
			{
				"UserName":"zhanlg",
				"TotalBytes":555352
			}
		]
	}
}

错误码

HttpCode 错误码 错误信息 描述
400 SAG.InstanceIdEmpty You must specify the SAG instance ID. 智能网关实例ID为空。
400 SAG.InstanceNoFound The specified SAG instance does not exist. 智能网关实例不存在。

访问错误中心查看更多错误码。