全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
视频直播

查询直播流历史在线人数

更新时间:2018-04-26 16:27:53

描述

查询指定直播流在指定时间段的历史在线人数,即拉流数的时间序列

请求参数

参数 类型 是否必选 示例值 描述
Action String DescribeLiveStreamHistoryUserNum

系统规定参数,取值:DescribeLiveStreamHistoryUserNum

AppName String testApp

直播流所属应用名称

DomainName String www.yourdomain.com

您的域名

StreamName String testStream

直播流名

StartTime String 2017-12-21T08:00:00:00Z

开始时间,UTC格式,StartTime和EndTime时间间隔在一天内

EndTime String 2017-12-22T08:00:00:00Z

结束时间,UTC格式,StartTime和EndTime时间间隔在一天内,且EndTime不超过当前时间

返回参数

参数 类型 示例值 描述
LiveStreamUserNumInfos

直播流历史在线人数信息

  └UserNum String 1

人数

  └StreamTime String 2017-10-20T06:20:00Z

流时间,UTC格式

示例

请求示例

  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&<公共请求参数>

关于公共请求参数详细内容,请参考 公共请求参数

正常返回示例

XML 格式

  1. <DescribeLiveStreamHistoryUserNumResponse>
  2. <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F5FF8</RequestId>
  3. <LiveStreamUserNumInfos>
  4. <LiveStreamUserNumInfo>
  5. <UserNum>0</UserNum>
  6. <StreamTime>2017-10-20T06:20:00Z</StreamTime>
  7. </LiveStreamUserNumInfo>
  8. <LiveStreamUserNumInfo>
  9. <UserNum>2</UserNum>
  10. <StreamTime>2017-10-20T06:19:00Z</StreamTime>
  11. </LiveStreamUserNumInfo>
  12. ......(省略)
  13. </LiveStreamUserNumInfos>
  14. </DescribeLiveStreamHistoryUserNumResponse>

JSON 格式

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

异常返回示例

JSON 格式

  1. {
  2. "Code":"InternalError",
  3. "HostId":"live.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
  6. }

错误码

查看本产品错误码

本文导读目录