（即将下线）查询托管任务 - ListTakeOverTask
功能介绍
查询OBS存量托管任务列表。
接口约束
-
现网还在用增量托管功能的用户，功能下线后，仍可正常使用。但是建议用户将数据从OBS桶迁移至VOD服务进行存储，不要依赖托管功能，详情请参见【下线公告】华为云视频点播VOD服务音视频托管功能下线。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
vod:stock:list
List
-
-
-
-
URI
GET /v1.0/{project_id}/asset/obs/host/stock/task
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID，获取方法请参考获取项目ID |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 否 | String | 用户Token，使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
| Authorization | 否 | String | 使用AK/SK方式认证时必选，携带的鉴权信息。 |
| X-Sdk-Date | 否 | String | 使用AK/SK方式认证时必选，请求的发生时间。 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| tasks | Array of TakeOverTask objects | 托管任务信息。 |
| total | Integer | 任务数量。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| bucket | String | 桶名。 |
| object | String | 目录/文件名。 |
| host_type | Integer | 托管类型。 取值如下： |
| 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 | 任务状态。 |
| exec_desc | String | 媒资的任务执行描述汇总。 |
状态码：403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 处理失败返回。 |
错误码
请参见错误码。
