添加主备合流 -

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

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