調用AddLiveStreamMerge添加主備合流配置。

QPS限制

本接口的單用戶QPS限制為100次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。更多信息，請參見QPS限制。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 AddLiveStreamMerge

系統規定參數。取值：AddLiveStreamMerge。
DomainName String 是 example.com

播流域名。
AppName String 是 app

合流輸出App名稱。
StreamName String 是 StreamName

合流輸出Stream名稱。
InAppName1 String 是 app1

合流輸入主流應用名稱，輸入的AppName必須與主流推流地址中的AppName保持一致，方可生效。
InStreamName1 String 是 InStream1

合流輸入主流直播流名稱，輸入的AppName必須與主流推流地址中的AppName保持一致，方可生效。
InAppName2 String 是 app2

合流輸入備流應用名稱，輸入的AppName必須與備流推流地址中的AppName保持一致，方可生效。
InStreamName2 String 是 stream2

合流輸入備流直播流名稱，輸入的AppName必須與備流推流地址中的AppName保持一致，方可生效。
StartTime String 是 2020-05-29T00:00:00Z

合流開始時間。

日期格式按照ISO8601表示法，并使用UTC+0時間，格式為yyyy-MM-ddTHH:mm:ssZ。
EndTime String 是 2020-05-29T01:00:00Z

合流結束時間。

日期格式按照ISO8601表示法，并使用UTC+0時間，格式為yyyy-MM-ddTHH:mm:ssZ。

說明 開始時間與結束時間最大相差7天。
Protocol String 否 rtmp

直播流協議，取值：

  • rtmp（默認值）
  • rtc
說明 AppName、InAppName1、InAppName2三個配置項中不可與其它兩個中任意一個重復；StreamName、InStreamName1、InStreamName2三個配置項中不可與其它兩個中任意一個重復。

返回數據

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

請求ID。

示例

請求示例

http(s)://live.aliyuncs.com/?Action=AddLiveStreamMerge
&DomainName=example.com
&AppName=app
&StreamName=StreamName
&InAppName1=app1
&InStreamName1=InStream1
&InAppName2=app2
&InStreamName2=stream2
&StartTime=2020-05-29T00:00:00Z
&EndTime=2020-05-29T01:00:00Z
&Protocol=rtmp
&公共請求參數

正常返回示例

XML格式

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

<AddLiveStreamMergeResponse>
    <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</AddLiveStreamMergeResponse>

JSON格式

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

{
  "RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 InvalidStartTime.Malformed Specified parameter StartTime is not valid. StartTime參數錯誤，請您確認該StartTime參數是否正確。
400 InvalidEndTime.Malformed Specified parameter EndTime is not valid. 結束時間錯誤，請您確認結束時間是否正確。
400 ConfigAlreadyExists Config has already exist. 配置已添加。

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