查询直播拉流转推任务 - ListPullTasks
功能介绍
查询直播拉流转推任务。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
live:stream:listPullTask
Read
-
-
-
-
URI
GET /v1/{project_id}/pull/stream/task
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID,获取方法请参考获取项目ID。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
region | 否 | String | 参数解释: 任务所在区域 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
offset | 否 | Integer | 参数解释: 偏移量 约束限制: 不涉及 默认取值: 不涉及 取值范围: 0~2147483647 |
limit | 否 | Integer | 参数解释: 每页记录数 约束限制: 不涉及 默认取值: 不涉及 取值范围: 1~100 |
task_id | 否 | String | 参数解释: 任务ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 否 | String | 用户Token,使用Token鉴权方式时必填。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
task_infos | Array of LivePullTaskInfo objects | 参数解释: 直播拉流任务列表 |
request_id | String | 参数解释: 请求ID 取值范围: 不涉及 |
total | Integer | 参数解释: 总条目数 取值范围: 0~10000 |
参数 | 参数类型 | 描述 |
|---|---|---|
task_id | String | 参数解释: 任务ID 取值范围: 不涉及 |
status | String | 参数解释: 任务状态 取值范围: 不涉及 |
create_time | String | 参数解释: 创建时间 取值范围: 不涉及 |
region | String | 参数解释: 任务执行区域 取值范围: 不涉及 |
source_type | String | 参数解释: 拉流源类型 取值范围: |
source_urls | Array of strings | 参数解释: 拉流源URL |
domain | String | 参数解释: 直播推流域名 取值范围: 字符长度为[1-255]位 |
app_name | String | 参数解释: 应用名称 取值范围: 字符长度为[1-128]位 |
stream_name | String | 参数解释: 流名称 取值范围: 字符长度为[1-512]位 |
push_args | String | 参数解释: 推流参数 取值范围: 不涉及 |
destination_url | String | 参数解释: 完整的目标URL。 取值范围: |
start_time | String | 参数解释: 任务启动时间,时间格式:"2006-01-02T15:04:05Z"。 取值范围: 不涉及 |
end_time | String | 参数解释: 任务结束时间,时间格式:"2006-01-02T15:04:05Z"。 取值范围: 不涉及 |
callback_events | Array of strings | 参数解释: 要回调的事件列表(不填则回调全部) |
callback_url | String | 参数解释: 回调接收地址 取值范围: 不涉及 |
backup_source_type | String | 参数解释: 备源的类型 取值范围: PullLivePushLive:直播 |
backup_source_urls | Array of strings | 参数解释: 备源URL。数组长度为[0,30],且仅当source_type为PullVodPushLive生效。 |
vod_loop_time | String | 参数解释: 视频播放循环次数,仅当source_type为PullVodPushLive生效。 取值范围: |
vod_start_video_index | Integer | 参数解释: 播放文件索引,从0开始表示第一个文件,最大值 len(source_urls)-1。仅当source_type为PullVodPushLive生效。 取值范围: 0~8192 |
vod_start_video_time | Integer | 参数解释: 指定从上述指定文件的第几秒开始播放,仅当source_type为PullVodPushLive生效。 取值范围: 0~2100000000 |
vod_refresh_type | String | 参数解释: 修改任务时文件切换方式 取值范围: |
状态码:400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误描述 |
request_id | String | 请求id |
状态码:404
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误描述 |
request_id | String | 请求id |
请求示例
GET https://{endpoint}/v1/{project_id}/pull/stream/task?region=cn-north-4&task_id=xxxxxx 响应示例
状态码:200
查询直播拉流转推任务成功
{
"request_id" : "85968475-e92f-42db-a754-08e627b6d8dd",
"total" : 1,
"task_infos" : [ {
"task_id" : "7864b3dc-e92f-42db-a754-08e627b6d8dd",
"status" : "suspend",
"create_time" : "2018-05-19T10:00:00Z",
"region" : "cn-north-4",
"source_type" : "PullLivePushLive",
"source_urls" : [ "rtmp://play.example.huawei.com/live/stream1" ],
"domain" : "publish.example.huawei.com",
"app_name" : "live",
"stream_name" : "test",
"start_time" : "2018-05-19T18:00:00Z",
"end_time" : "2018-05-19T21:00:00Z",
"push_args" : "arg1=value1",
"destination_url" : "",
"callback_events" : [ "TaskStart", "TaskExit", "TaskAlarm" ],
"callback_url" : "callback.example.com",
"backup_source_type" : "PullLivePushLive",
"backup_source_urls" : [ "rtmp://play.example.huawei.com/live/stream1_bak" ]
} ]
} 状态码:400
查询直播拉流转推任务失败
{
"error_code" : "LIVE.100011001",
"error_msg" : "Request Illegal",
"request_id" : "85968475-e92f-42db-a754-08e627b6d8dd"
} 状态码:404
任务不存在
{
"error_code" : "LIVE.100011001",
"error_msg" : "Request Illegal",
"request_id" : "85968475-e92f-42db-a754-08e627b6d8dd"
} 状态码
状态码 | 描述 |
|---|---|
200 | 查询直播拉流转推任务成功 |
400 | 查询直播拉流转推任务失败 |
404 | 任务不存在 |
错误码
请参见错误码。

