全部产品
Search
文档中心

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

更新时间:Jul 08, 2024

调用AddLivePullStreamInfoConfig添加直播拉流配置信息。

使用说明

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

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

<AddLivePullStreamInfoConfigResponse>
    <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CF8</RequestId>
</AddLivePullStreamInfoConfigResponse>

JSON格式

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

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

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