查询任务接口

最近更新时间:2025-10-24 15:25:21

我的收藏

功能描述

用于查询耗时任务执行情况。
说明:
任务的具体返回请参阅会产生异步任务的接口说明,部分接口会根据任务耗时情况返回同步或异步结果,此时异步结果通常与同步结果的格式保持一致。
仅能查询到任务结束时间在最近30天的任务,更早期的任务无法查询。

请求

请求示例

GET /api/v1/task/{LibraryId}/{SpaceId}/{TaskIdList}?access_token={AccessToken}&user_id={UserId}

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
SpaceId
空间 ID,必须指定该参数,如果媒体库为单租户模式,则该参数固定为连字符(-)
String
TaskIdList
任务 ID 列表,用逗号分隔,例如 1010,12,13,请根据实际任务填写
String
AccessToken
访问令牌,请参见 生成访问令牌
String
UserId
用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参见 生成访问令牌接口
String

请求体

该请求无请求体。

响应

响应码

获取成功,返回 HTTP 200 OK。

响应体

application/json
响应体示例:
[
{
"taskId": 10,
"status": 200,
"result": {
"convertFrom": [
"foo",
"bar",
"test.docx"|
],
"path": [
"foo",
"ba_1x1",
"test.pdf"
],
"srcInode": "17abb6£dc6626£4900063£aed543e056" ,
"dstInode": "10820£030bc92a76000640ca0a4ab©d&"|
}
]
响应体字段说明:
响应参数
描述
类型
taskId
任务 ID
Int
status
任务状态码,包含以下状态:
202:任务进行中。
200:任务成功完成且有返回结果,返回结果在 result 字段中。
204:任务成功完成且无返回结果。
500:任务执行失败。
Int
result
任务成功完成后的返回结果
Object
result 中包含以下参数:
响应参数
描述
类型
convertFrom
转换路径
List
path
路径
List
srcInode
源节点
String
dstInode
目标节点
String

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。