添加拉流配置信息，包括源站地址、开始时间和结束时间。
接口说明
-
请确保在使用该接口前，已充分了解直播拉流的收费方式和价格。计费详情，请参见标准直播。
-
拉流是将第三方直播流地址拉取到阿里直播中心进行加速分发的过程。
-
本接口仅支持固定拉流方式，即指定拉流的起始时间和结束时间，在指定时间进行拉流直播。
-
控制台支持固定拉流和触发拉流两种方式，详细内容请参见拉流配置。
-
AppName 与 StreamName 可自定义修改，不同的值生成不同的直播流地址。可用地址生成器生成。
-
(DomainName, AppName, StreamName)三元组只能对应一个配置，如果该三元组已经存在一个配置了，再调用本接口添加配置会返回配置已存在错误。
QPS 限制
本接口的单用户 QPS 限制为 15 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
live:AddLivePullStreamInfoConfig |
create |
*Domain
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
否 |
地域 ID。 |
cn-shanghai |
| DomainName |
string |
是 |
您的拉流域名为用户的主播流域名。 |
example.com |
| AppName |
string |
是 |
直播流所属应用名称，用户自定义。 |
liveApp**** |
| StreamName |
string |
是 |
直播流名，用户自定义。 |
liveStream**** |
| SourceUrl |
string |
是 |
用户的直播流所在的源站完整 url。多个源站可以填多个地址，用英文分号（;）分隔。 说明
仅支持拉取直播流，支持 RTMP、FLV、HLS、SRT 格式。 |
rtmp://guide.aliyundoc.com/liveApp****/liveStream****;rtmp://developer.aliyundoc.com/liveApp****/liveStream**** |
| StartTime |
string |
是 |
拉流开始时间。 StartTime 和 EndTime 时间间隔在 7 天内。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。 |
2017-12-21T08:00:00Z |
| EndTime |
string |
是 |
拉流结束时间。 StartTime 和 EndTime 时间间隔在 7 天内，且 EndTime 超过当前时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。 |
2017-12-22T08:00:00Z |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
16A96B9A-F203-4EC5-8E43-CB92E68F4CF8 |
示例
正常返回示例
JSON格式
{
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CF8"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | |
| 400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | |
| 400 | InvalidEndTime.Mismatch | Specified end time does not math the specified start time or current time. | |
| 400 | Duration.Exceed | Duration between StartTime and EndTime is too long. | |
| 400 | ConfigAlreadyExists | Config has already exist. | |
| 400 | PullStreamOverLimit | Pull stream is over limit for this domainName. | |
| 400 | InvalidParam | Parameter invalid. | 输入参数不合法 |
| 500 | InternalError | The request processing has failed due to backend service exception. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。