添加直播拉流配置 - 视频直播

使用说明

拉流是将第三方直播流地址拉取到阿里直播中心进行加速分发的过程。
本接口仅支持固定拉流方式，即指定拉流的起始时间和结束时间，在指定时间进行拉流直播。
控制台支持固定拉流和触发拉流两种方式，详细内容请参见拉流配置。

QPS限制

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

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	AddLivePullStreamInfoConfig	系统规定参数。取值：AddLivePullStreamInfoConfig。
DomainName	String	是	example.com	您的拉流域名为用户的主播流域名。
AppName	String	是	liveApp****	直播流所属应用名称，用户自定义。
StreamName	String	是	liveStream****	直播流名，用户自定义。
SourceUrl	String	是	rtmp://guide.aliyundoc.com/liveApp**/liveStream;rtmp://developer.aliyundoc.com/liveApp/liveStream**	用户的直播流所在的源站完整url。多个源站可以填多个地址，用英文分号（;）分隔。说明仅支持拉取直播流，支持RTMP、FLV、HLS、SRT格式。
StartTime	String	是	2017-12-21T08:00:00Z	拉流开始时间。 StartTime和EndTime时间间隔在7天内。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
EndTime	String	是	2017-12-22T08:00:00Z	拉流结束时间。 StartTime和EndTime时间间隔在7天内，且EndTime超过当前时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

返回数据


名称	类型	示例值	描述
RequestId	String	16A96B9A-F203-4EC5-8E43-CB92E68F4CF8	请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=AddLivePullStreamInfoConfig
&AppName=liveApp****
&DomainName=example.com
&EndTime=2017-12-22T08:00:00Z
&StartTime=2017-12-21T08:00:00Z
&SourceUrl=rtmp://guide.aliyundoc.com/liveApp****/liveStream****;rtmp://developer.aliyundoc.com/liveApp****/liveStream****
&StreamName=liveStream****
&<公共请求参数>

正常返回示例

XML格式

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

<?xml version="1.0" encoding="UTF-8" ?>
<AddLivePullStreamInfoConfigResponse>
	<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CF8</RequestId>
</AddLivePullStreamInfoConfigResponse>

JSON格式

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

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

错误码


HttpCode	错误码	错误信息	描述
400	InvalidStartTime.Malformed	Specified StartTime is malformed.	StartTime参数错误，请您确认该StartTime参数是否正确。
400	InvalidEndTime.Malformed	Specified EndTime is malformed.	结束时间错误，请您确认结束时间是否正确。
400	ConfigAlreadyExists	Config has already exist.	配置已添加。

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