添加拉流配置

最近更新时间:2019-08-15 21:40:37

1. 接口描述

接口请求域名: live.tencentcloudapi.com 。

创建临时拉流转推任务,目前限制添加10条任务。

注意:该接口用于创建临时拉流转推任务, 拉流源地址即FromUrl 可以是腾讯或非腾讯数据源, 但转推目标地址即ToUrl 目前限制为已注册的腾讯直播域名。

默认接口请求频率限制:100次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:CreatePullStreamConfig
Version String 公共参数,本接口取值:2018-08-01
Region String 公共参数,本接口不需要传递此参数。
FromUrl String 源Url。目前可支持直播流及点播文件。
ToUrl String 目的Url,目前限制该目标地址为腾讯域名。
AreaId Integer 区域id:
1-深圳,
2-上海,
3-天津,
4-中国香港。
IspId Integer 运营商id:
1-电信,
2-移动,
3-联通,
4-其他。
注:AreaId为4的时候,IspId只能为其他。
StartTime String 开始时间。
使用UTC格式时间,
例如:2019-01-08T10:00:00Z。
EndTime String 结束时间,注意:
1. 结束时间必须大于开始时间;
2. 结束时间和开始时间必须大于当前时间;
3. 结束时间 和 开始时间 间隔必须小于七天。
使用UTC格式时间,
例如:2019-01-08T10:00:00Z。

3. 输出参数

参数名称 类型 描述
ConfigId String 配置成功后的id。
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 请求示例

输入示例

https://live.tencentcloudapi.com/?Action=CreatePullStreamConfig
&FromUrl=rtmp://5000.liveplay.myqcloud.com/live/stream1
&ToUrl=rtmp://5000.livepush.myqcloud.com/live/stream2
&AreaId=1
&IspId=1
&StartTime=2018-12-31T11:02:00Z
&EndTime=2018-12-31T12:02:00Z
&<公共请求参数>

输出示例

{
  "Response": {
    "ConfigId": "123",
    "RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
FailedOperation.CallOtherSvrFailed 调用内部服务失败。
InternalError 内部错误
InternalError.CallOtherSvrError 调用内部服务错误。
InternalError.GetBizidError 获取用户账号错误。
InternalError.InvalidInput 参数检校不通过。
InvalidParameter 参数错误
InvalidParameterValue 参数取值错误
MissingParameter 缺少参数错误
ResourceNotFound.UserNotExist 用户未注册直播。