调用DescribeLiveStreamMerge查询主备合流配置。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeLiveStreamMerge

系统规定参数。取值：DescribeLiveStreamMerge。
DomainName String 是 example.com

播流域名。
AppName String 否 app

合流输出App名称。
StreamName String 否 StreamName

合流输出Stream名称。
Protocol String 否 rtmp

播流协议，取值：

  • rtmp（默认值）
  • rtc

返回数据

名称 类型 示例值 描述
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID。
LiveStreamMergeList Array of LiveStreamMerge
LiveStreamMerge
Protocol String rtmp

直播流协议。
StreamName String StreamName

合流输出Stream名称。
InAppName2 String app2

合流输入备流应用名称。
ExtraInAppStreams String app3/stream3,app4/stream4,app5/stream5,…,appN/streamN

合流输入第3路-第N路的app和stream。
InStreamName1 String InStream1

合流输入主流直播流名称。
StreamUsing String InStream1

当前使用的Stream。
DomainName String example.com

播流域名。
AppUsing String app1

当前使用的App。
InStreamName2 String stream2

合流输入备流直播流名称。
EndTime String 2020-05-29T01:00:00Z

合流结束时间。
AppName String app

合流输出App名称。
StartTime String 2020-05-29T00:00:00Z

合流开始时间。
InAppName1 String app1

合流输入主流应用名称。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveStreamMerge
&DomainName=example.com
&AppName=app
&StreamName=StreamName
&Protocol=rtmp
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeLiveStreamMergeResponse>
    <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
    <LiveStreamMergeList>
        <Protocol>rtmp</Protocol>
        <StreamName>StreamName</StreamName>
        <InAppName2>app2</InAppName2>
        <ExtraInAppStreams>app3/stream3,app4/stream4,app5/stream5,…,appN/streamN</ExtraInAppStreams>
        <InStreamName1>InStream1</InStreamName1>
        <StreamUsing>InStream1</StreamUsing>
        <DomainName>example.com</DomainName>
        <AppUsing>app1</AppUsing>
        <InStreamName2>stream2</InStreamName2>
        <EndTime>2020-05-29T01:00:00Z</EndTime>
        <AppName>app</AppName>
        <StartTime>2020-05-29T00:00:00Z</StartTime>
        <InAppName1>app1</InAppName1>
    </LiveStreamMergeList>
</DescribeLiveStreamMergeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  "LiveStreamMergeList" : [ {
    "Protocol" : "rtmp",
    "StreamName" : "StreamName",
    "InAppName2" : "app2",
    "ExtraInAppStreams" : "app3/stream3,app4/stream4,app5/stream5,…,appN/streamN",
    "InStreamName1" : "InStream1",
    "StreamUsing" : "InStream1",
    "DomainName" : "example.com",
    "AppUsing" : "app1",
    "InStreamName2" : "stream2",
    "EndTime" : "2020-05-29T01:00:00Z",
    "AppName" : "app",
    "StartTime" : "2020-05-29T00:00:00Z",
    "InAppName1" : "app1"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 ConfigAlreadyExists Config has already exist. 配置已添加。

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