調用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. 配置已添加。

訪問錯誤中心查看更多錯誤碼。