文档首页/ 视频点播 VOD/ API参考/ （即将下线）OBS托管管理/ （即将下线）查询托管任务 - ListTakeOverTask
更新时间：2025-10-29 GMT+08:00
在线调试
CLI示例
查看PDF
分享

（即将下线）查询托管任务 - ListTakeOverTask

功能介绍

查询OBS存量托管任务列表。

接口约束

  • 音视频托管功能即将下线，功能下线后，将不再对新用户开放音视频托管功能。

  • 现网还在用增量托管功能的用户，功能下线后，仍可正常使用。但是建议用户将数据从OBS桶迁移至VOD服务进行存储，不要依赖托管功能，详情请参见【下线公告】华为云视频点播VOD服务音视频托管功能下线。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v1.0/{project_id}/asset/obs/host/stock/task

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方法请参考获取项目ID
表2 Query参数

参数

是否必选

参数类型

描述

status

否

String

任务状态。

  • PROCESSING：处理中

  • SUCCEED：处理成功

  • FAILED：处理失败

task_id

否

String

任务ID。

page

否

Integer

分页编号，默认为0。

size

否

Integer

每页记录数。

默认10，范围[1,100]，指定task_id时该参数无效。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

用户Token，使用Token鉴权方式时必选。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

Authorization

否

String

使用AK/SK方式认证时必选，携带的鉴权信息。

X-Sdk-Date

否

String

使用AK/SK方式认证时必选，请求的发生时间。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

tasks

Array of TakeOverTask objects

托管任务信息。

total

Integer

任务数量。
表5 TakeOverTask

参数

参数类型

描述

bucket

String

桶名。

object

String

目录/文件名。

host_type

Integer

托管类型。

取值如下：

  • 0：表示存储到点播桶

  • 1：表示存储在租户桶

  • 2：表示存储到租户OBS桶中，且输出目录与源文件的存储目录相同。

output_bucket

String

输出桶 。

output_path

String

输出路径 。

task_id

String

任务ID。

suffix

Array of strings

托管文件类型。

template_group_name

String

转码模板组 。

create_time

String

创建时间。

end_time

String

结束时间。

status

String

任务状态。

  • PROCESSING：处理中

  • SUCCEED：处理成功

  • FAILED：处理失败

exec_desc

String

媒资的任务执行描述汇总。

状态码：403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

查询obs存量托管任务列表

GET https://{endpoint}/v1.0/{project_id}/asset/obs/host/stock/task

响应示例

状态码：200

处理成功返回。

{
  "tasks" : [ {
    "bucket" : "obs-test",
    "object" : "play_violin.mp4",
    "host_type" : 0,
    "output_bucket" : "",
    "output_path" : null,
    "task_id" : "973",
    "suffix" : [ ],
    "template_group_name" : null,
    "create_time" : "20210629074248",
    "end_time" : "20210629074250",
    "status" : "SUCCEED",
    "exec_desc" : null
  } ],
  "total" : 1
}

状态码：403

处理失败返回。

{
  "error_code" : "VOD.10053",
  "error_msg" : "The request parameter is illegal, illegal field: {xx}."
}

状态码

状态码

描述

200

处理成功返回。

403

处理失败返回。

错误码

请参见错误码。

相关文档