查询异步任务详情 - getBatchTask

功能介绍

查询异步任务详情。

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/share/taskDetail

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
Authorization	是	String	该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token}
X-Traceid	否	String	业务跟踪id（必须58位）
X-User-Id	是	String	用户id，用于app鉴权
X-Date	是	String	日期，用于app鉴权
Host	是	String	地址，用于app鉴权

表2 请求Body参数
参数	是否必选	参数类型	描述
taskId	是	String	任务ID
shareId	是	String	分享id
kdstoken	否	String	token

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
code	Integer	响应码
msg	String	响应信息
jobInfo	JobInfo object	工作信息
taskInfos	TaskInfo object	任务信息

表4 JobInfo
参数	参数类型	描述
userId	String	用户id
taskId	String	任务id
taskType	Integer	任务类型，1：下载；2：转存
taskStatus	Integer	任务状态，0：待处理，1：处理中，2：已完成，3：已取消
taskResultCode	Integer	任务处理结果，1：全部成功，2：部分失败，3：全部失败
createTime	String	任务创建时间，格式为14位时间戳yyyyMMddHHmmss
startTime	String	任务开始时间，格式为14位时间戳yyyyMMddHHmmss
endTime	String	任务结束时间，格式为14位时间戳yyyyMMddHHmmss
progress	Integer	任务进度，进度百分比的值，如进度为70%时，返回的值是70
downloadUrl	String	压缩包下载链接

表5 TaskInfo
参数	参数类型	描述
fileId	String	老文件id
status	String	状态。0：待处理； 1：成功； 2：失败
newFileId	String	新文件id
srcContainerId	String	源空间id

请求示例

POST /koodrive/ose/v1/share/taskDetail

{
  "taskId" : "string",
  "shareId" : "string",
  "kdstoken" : "string"
}

响应示例

状态码：200

{
  "jobInfo" : {
    "userId" : "0929b397a3424384b32cf8f96d9f35e4|1465814559892958208",
    "taskId" : "1521827471237047552",
    "taskType" : 1,
    "taskStatus" : 2,
    "taskResultCode" : 1,
    "createTime" : "20240930091932",
    "startTime" : "20240930091932",
    "endTime" : "20240930091933",
    "progress" : 100
  },
  "taskInfos" : [ {
    "fileId" : "FmvP8my7yGTvCmKhweL1BoY6kWjRt83A7",
    "status" : "1",
    "newFileId" : "FmylhS-VxkVrHr0vRwydKgo9-x-SmcPha",
    "srcContainerId" : "IAACk0hRXpq9DAWkA1465823622533999616"
  }, {
    "fileId" : "FulYbSXt1ovCywA4qda1Fe64BveY4dMvw",
    "status" : "1",
    "newFileId" : "FjRrf91UdJQnffuMcw-xIIJlNeVgWHEwJ",
    "srcContainerId" : "IAACk0hRXpq9DAWkA1465823622533999616"
  } ],
  "code" : 0,
  "msg" : "成功"
}