文档简介:
GetConcurrentConnection
此操作用来查询用户的并发连接数。
l 请求参数
名称 |
描述 |
是否必填 |
Action |
GetConcurrentConnection。 |
是 |
BeginDate |
指定查询并发连接数的起始时间,统计数据的起始时间为开始日期(时区为:UTC+8)的00:00。 类型:Time。 取值:格式为yyyy-MM-dd。 |
是 |
EndDate |
指定查询并发连接数的结束时间,返回数据的时间为当天日期(时区为:UTC+8)的最后一个数据。 类型:Time。 取值:格式为yyyy-MM-dd。EndDate不能早于BeginDate。 说明:EndDate与BeginDate的间隔不大于1天。 |
是 |
Bucket |
指定查询并发连接数Bucket的名称。如果不指定Bucket名称,则表示查询账户下所有Bucket的并发连接数之和。 类型:字符串。 取值:3~63位字符串,只能由小写字母、数字、短横线(-)和点(.)组成。 |
否 |
Region |
指定查询并发连接数的数据位置。如果不指定数据位置名称,则查询账户名下所有数据位置的并发连接数之和。 类型:字符串。 取值:ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、LaSa、WuHu、WuHan、ShenZhen、SH2、SuZhou。 |
否 |
InternetType |
指定返回并发连接数的网络类型-互联网/非互联网。 类型:字符串。 取值: l all:指定返回互联网并发连接数和非互联网并发连接数; l internet:指定返回互联网的并发连接数; l noninternet:指定返回非互联网的并发连接数。 默认值为all。 |
否 |
Freq |
指定返回统计数据的采样粒度。 类型:Enum。 取值:by5min:统计数据的采样粒度为5分钟; 默认值为by5min。 |
否 |
l 响应结果
名称 |
描述 |
Account |
发出请求的账户名。 |
UserName |
发出请求的用户名。如果根用户发送的该请求,则UserName为root。 |
TimeZone |
返回数据的时区,统一为UTC +0800。 |
InternetType |
并发连接数网络类型-互联网/非互联网: l all:互联网并发连接数和非互联网并发连接数; l internet:互联网的并发连接数; l noninternet:非互联网的并发连接数。 |
Freq |
返回数据的频率,by5min:每5分钟统计一次。 |
BucketName |
Bucket名字。如果用户在请求中没有携带Bucket参数,BucketName为空。 |
RegionName |
数据位置,如果用户在请求中没有携带Region参数,RegionName为空。 |
Statistics.Date |
返回结果对应的时间。 |
Statistics.Data.InternetConnection |
互联网的并发连接数。 |
Statistics.Data.NonInternetConnection |
非互联网的并发连接数。 |
l 请求示例
按5分钟(by5min)查询Bucket为lt-bucket1、数据位置为ZhengZhou、2019-10-15至2019-10-16的并发量。
GET /?Action=GetConcurrentConnection&BeginDate=2019-10-16&EndDate=2019-10-16&Bucket=lt-bucket1&Freq=by5min&Region=ZhengZhou HTTP/1.1 Date: Wed, 16 Oct 2019 07:11:39 GMT Authorization: AWS 7799e793ce4624ee7e5a:d4KttP1KihaC2YEI45Ot6dkqONE= Host: oos-cn-mg.ctyunapi.cn |
l 返回示例
HTTP/1.1 200 OK Date: Wed, 16 Oct 2019 07:11:39 GMT x-amz-request-id: 43f5cbc9bef047d3 Content-Length: 24493 Server: CTYUN
<?xml version="1.0" encoding="UTF-8"?> <GetConcurrentConnectionResponse> <Account>test@oos.cn</Account> <UserName>user_test1</UserName> <TimeZone>UTC +0800</TimeZone> <InternetType>all</InternetType> <Freq>by5min</Freq> <BucketName>lt-bucket1</BucketName> <RegionName>ZhengZhou</RegionName> <Statistics> <Date>2019-10-16 00:00</Date> <Data> <InternetConnection>0</InternetConnection> <NonInternetConnection>0</NonInternetConnection> </Data> </Statistics> <Statistics> ... </Statistics> </GetConcurrentConnectionResponse> |