QueryLiveDomainMultiStreamList - 查询双流灾备在线记录

查询双流灾备在线记录。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

live:QueryLiveDomainMultiStreamList

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
Domain	string	是	主播放域名。	demo.aliyundoc.com
StreamName	string	否	直播流名称。用于做过滤，精确搜索。	teststream
StartTime	string	否	查询范围的起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。 StartTime 和 EndTime 时间间隔在 7 天内。	2024-12-01T01:00:00Z
EndTime	string	否	结束时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。结束时间需大于起始时间。起止时间和结束时间，间隔不超过 7 天。默认最近 24 小时。	2024-12-02T01:00:00Z
PageNumber	integer	否	当前页码。默认值为 1。	1
PageSize	integer	否	单页显示的数量，默认值：10。取值范围：1~100。	10

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	CF60DB6A-7FD6-426E-9288-122CC1A5****
PageNumber	integer	当前页码。	1
PageSize	integer	每页大小。	10
TotalCount	integer	总条数。	19
OnlineStreams	array	在线记录数。
	object
Domain	string	主播流域名。	play.***.com
AppName	string	应用名称。	apptest
StreamName	string	直播流名称。	teststream
OptimalMode	string	功能开关。取值： on：开启 off：关闭	on
UpstreamList	array	表示所有备选的流。
	object
UpstreamSequence	string	推流唯一标识。	***test_Alirewrite1
UpstreamIp	string	推流客户端 IP。	1.1.1.1
UpstreamTime	string	推流时间。	2024-11-13T09:20:47Z
MasterFlag	boolean	主备标记。说明用于标记当前合流分发的是哪个流。	false
ChangeLogs	array	切流记录。
	object
ChangeTime	string	切流时间。	2024-11-13T09:20:47Z
ChangeReason	string	切流原因用户手动切流 merge cut manually 主流没有数据 master stream no data 主流质量劣化 master stream low quality。	merge cut manually
MasterUpstream	string	切流后实际使用的流。	rtmp://118.178.168.35:1936/wwMultitest/pull.livetest2.aliyunlive.com_wwMultitest428_AliRewrite_2?vhost=pull.livetest2.aliyunlive.com&live_rtmp_test=on
UpstreamSequence	string	切流后的流标识。	***test_AliRewrite_2
UpstreamIp	string	切流后使用的 ip。	1.1.1.1

示例

正常返回示例

JSON格式

{
  "RequestId": "CF60DB6A-7FD6-426E-9288-122CC1A5****",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 19,
  "OnlineStreams": [
    {
      "Domain": "play.***.com",
      "AppName": "apptest",
      "StreamName": "teststream",
      "OptimalMode": "on",
      "UpstreamList": [
        {
          "UpstreamSequence": "***test_Alirewrite1",
          "UpstreamIp": "1.1.1.1",
          "UpstreamTime": "2024-11-13T09:20:47Z",
          "MasterFlag": false
        }
      ],
      "ChangeLogs": [
        {
          "ChangeTime": "2024-11-13T09:20:47Z",
          "ChangeReason": "merge cut manually",
          "MasterUpstream": "rtmp://118.178.168.35:1936/wwMultitest/pull.livetest2.aliyunlive.com_wwMultitest428_AliRewrite_2?vhost=pull.livetest2.aliyunlive.com&live_rtmp_test=on",
          "UpstreamSequence": "***test_AliRewrite_2",
          "UpstreamIp": "1.1.1.1"
        }
      ]
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter	%s.	参数错误
400	InvalidParam.CodeIllegalDuration	%s.	开始时间应该小于结束时间。
500	InternalError	%s.	直播 liveapi 服务端错误。

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

变更历史

更多信息，参考变更详情。