全部产品
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
视频直播

查询直播流历史在线人数

更新时间:2017-11-28 11:12:53

描述

查询直播流历史在线人数。

请求参数

参数 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:DescribeLiveStreamHistoryUserNum
DomainName String 您的域名
AppName String 直播流所属应用名称
StreamName String 直播流名
StartTime String 开始时间,UTC格式,StartTime和EndTime时间间隔在一天内
EndTime String 结束时间,UTC格式,StartTime和EndTime时间间隔在一天内,且EndTime不超过当前时间

返回参数

名称 类型 描述
RequestId String 该条任务请求ID
LiveStreamUserNumInfos LiveStreamUserNumInfo 直播流历史在线人数信息

数据类型

LiveStreamUserNumInfo

名称 类型 描述
UserNum Integer 人数
StreamTime String 流时间,UTC格式

特殊错误码

错误代码 描述 Http 状态码 语义
InvalidDomain.NotFound The domain provided does not exist in our records. 404 当前账户下未查到域名
IllegalOperation Illegal domain operate is not permitted. 403 不支持当前操作,如:非直播类域名
Missing DomainName DomainName is mandatory for this action. 400 缺少参数
InternalError The request processing has failed due to some unknown error. 500 后台发生未知错误
InvalidStartTime.Malformed Specified StartTime is malformed. 400 StartTime格式错误
InvalidEndTime.Malformed Specified EndTime is malformed. 400 EndTime格式错误
InvalidEndTime.Missmatch Specified end time does not math the specified start time or current time. 400 StartTime 和 EndTime 时间范围应在一天内,且EndTime超过当前时间

示例

请求示例

  1. https://live.aliyuncs.com?Action= DescribeLiveStreamHistoryUserNum&DomainName=live.aliyunlive.com&AppName=xxx&StartTime=2017-08-30T07:30:30Z&EndTime=2017-08-30T07:45:00Z&<公共请求参数>

返回示例

JSON格式

  1. {
  2. "LiveStreamUserNumInfos": {
  3. "LiveStreamUserNumInfo": [
  4. {
  5. "UserNum": 0,
  6. "StreamTime": "2017-10-20T06:20:00Z"
  7. },
  8. {
  9. "UserNum": 0,
  10. "StreamTime": "2017-10-20T06:19:00Z"
  11. },
  12. {
  13. "UserNum": 15,
  14. "StreamTime": "2017-10-20T06:18:00Z"
  15. },
  16. {
  17. "UserNum": 0,
  18. "StreamTime": "2017-10-20T06:17:00Z"
  19. },
  20. {
  21. "UserNum": 0,
  22. "StreamTime": "2017-10-20T06:16:00Z"
  23. },
  24. {
  25. "UserNum": 6,
  26. "StreamTime": "2017-10-20T06:15:00Z"
  27. },
  28. {
  29. "UserNum": 0,
  30. "StreamTime": "2017-10-20T06:14:00Z"
  31. }
  32. ]
  33. },
  34. "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F5FF8"
  35. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <DescribeLiveStreamHistoryUserNumResponse>
  3. <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F5FF8</RequestId>
  4. <LiveStreamUserNumInfos>
  5. <LiveStreamUserNumInfo>
  6. <UserNum>0</UserNum>
  7. <StreamTime>2017-10-20T06:20:00Z</StreamTime>
  8. </LiveStreamUserNumInfo>
  9. <LiveStreamUserNumInfo>
  10. <UserNum>2</UserNum>
  11. <StreamTime>2017-10-20T06:19:00Z</StreamTime>
  12. </LiveStreamUserNumInfo>
  13. ......(省略)
  14. </LiveStreamUserNumInfos>
  15. </DescribeLiveStreamHistoryUserNumResponse>
本文导读目录