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

说明 整体数据延时 2-5分钟。

请求参数

参数 类型 是否必选 示例值 描述
Action String DescribeLiveStreamHistoryUserNum 系统规定参数。取值:DescribeLiveStreamHistoryUserNum
AppName String testApp 直播流所属应用名称。
DomainName String example.com 您的域名。
EndTime String 2017-12-22T08:00:00Z

结束时间。

  • UTC格式。
  • StartTime和EndTime时间间隔在一天内,且EndTime不超过当前时间。
StartTime String 2017-12-21T08:00:00Z

开始时间。

  • UTC格式。
  • StartTime和EndTime时间间隔在一天内。
StreamName String testStream 直播流名。

返回参数

名称 类型 示例值 描述
RequestId String 40A4F36D-A7CC-473A-88E7-154F92242566 该条任务请求ID。
LiveStreamUserNumInfos 直播流历史在线人数信息。
  └UserNum String 1 人数。
  └StreamTime String 2017-10-20T06:20:00Z

流时间。

UTC格式。

示例

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

正常返回示例

JSON格式
{
    "LiveStreamUserNumInfos":{
        "LiveStreamUserNumInfo":[
            {
                "StreamTime":"2017-10-20T06:20:00Z",
                "UserNum":0
            },
            {
                "StreamTime":"2017-10-20T06:19:00Z",
                "UserNum":0
            },
            {
                "StreamTime":"2017-10-20T06:18:00Z",
                "UserNum":15
            },
            {
                "StreamTime":"2017-10-20T06:17:00Z",
                "UserNum":0
            },
            {
                "StreamTime":"2017-10-20T06:16:00Z",
                "UserNum":0
            },
            {
                "StreamTime":"2017-10-20T06:15:00Z",
                "UserNum":6
            },
            {
                "StreamTime":"2017-10-20T06:14:00Z",
                "UserNum":0
            }
        ]
    },
    "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F5FF8"
}

异常返回示例

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

错误码

查看本产品错误码