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

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