CreateLivePullToPush
创建拉流转推任务
服务地址：
华东2（上海）
输入参数
只看必填
Region指定任务启动所在区域
TaskName任务名称
StartTime任务开始时间
EndTime任务结束时间
SourceType源流类型
SourceProtocol源流协议名
SourceUrls源流URL地址列表
0源流URL地址
添加
DstUrl推流目标URL地址
RepeatNumber播放完后重复继续播放的次数
FileIndex文件索引
Offset启动偏移
CallbackUrlHTTP回调地址
RetryInterval重试间隔
RetryCount重试次数
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

注意 拉流转推功能当前处于公测阶段，您可以免费使用，公测结束后将正常收费，具体时间另行通知。

  • 调用本接口创建拉流转推任务。
  • 支持创建直播拉流任务，也支持创建点播拉流任务。
  • 任务创建后，到了设置的开始时间，会真正开始运行，到了设置的结束时间，会自动停止并删除清理。
  • 任务中设置的推流目标地址需要确保未被其他任务使用，不然会因为多个任务同时转推相同地址导致推流失败。
  • 拉流转推回调事件包括拉流转推任务运行状态变化回调和拉流转推任务已退出回调。更多信息，请参见拉流转推事件回调。

QPS 限制

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

请求参数

字段名称字段详情
Regionstring

指定任务启动所在区域，取值：展开详情

示例值:cn-shanghai枚举值:ap-northeast-1ap-southeast-1ap-southeast-5eu-central-1me-central-1cn-beijingcn-shanghaicn-shenzhencn-qingdaopreregion
TaskNamestring

任务名称，用于支持模糊查询，默认值为""。

示例值:test
StartTimestring

任务开始时间。展开详情

示例值:2024-08-26T10:30:00Z
EndTimestring

任务结束时间。展开详情

示例值:2024-08-27T14:30:00Z
SourceTypestring

源流类型，枚举值：展开详情

示例值:live枚举值:livevodurl
SourceProtocolstring

源流协议名。展开详情

示例值:rtmp
SourceUrlsarray<string>

源流 URL 地址列表。展开详情

示例值:testurls
DstUrlstring

推流目标 URL 地址。展开详情

示例值:rtmp://pushtest.********.aliyunlive.com/pulltest493/pulltest-w434
RepeatNumberinteger<int32>

播放完后重复继续播放的次数。取值：展开详情

示例值:0
FileIndexinteger<int32>

文件索引，从第 n 个文件开始播放起。

示例值:0
Offsetinteger<int32>

启动偏移，视频文件起始偏移值。单位：秒。取值：大于 0。展开详情

示例值:2
CallbackUrlstring

HTTP 回调地址，默认为空。展开详情

示例值:https://callback*****.com参考取值来源:
    ModifyLiveMessageAppCallback
RetryIntervalinteger<int32>

重试间隔，单位秒，取值区间[60,300]，默认 60 秒。

示例值:60取值 <= 300
RetryCountinteger<int32>

重试次数，默认值为 3。

示例值:3

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:16A96B9A-F203-4EC5-8E43-CB92E68*****
RetCodeinteger<int32>

返回码。展开详情

示例值:0
Descriptionstring

错误描述。

示例值:OK
TaskIdstring

任务 ID。

示例值:fd245384-4067-4f91-9d75-9666a6bc9****
变更历史
暂无变更历史