查询异步任务详情 - getBatchTask
功能介绍
查询异步任务详情。
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/share/taskDetail
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | String | 参数解释: 该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token} 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
| X-Traceid | 否 | String | 参数解释: 业务跟踪id(必须58位) 约束限制: 不涉及 取值范围: 长度为58位 默认值: 不涉及 |
| X-User-Id | 是 | String | 参数解释: KooDrive侧用户id,用于app鉴权 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
| X-Date | 是 | String | 参数解释: 日期,用于app鉴权,格式为yyyyMMdd‘T’HHmmss‘Z’ 约束限制: 距当前时间15分钟以内,不能晚于当前时间 取值范围: 不涉及 默认值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| taskId | 是 | String | 参数解释: 创建异步分享返回的任务ID 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
| shareId | 是 | String | 参数解释: 分享ID 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
| kdstoken | 否 | String | 参数解释: 分享临时token 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | Integer | 响应码 |
| msg | String | 响应信息 |
| jobInfo | JobInfo object | 工作信息 |
| taskInfos | TaskInfo object | 任务信息 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| userId | String | 用户id |
| taskId | String | 任务id |
| taskType | Integer | 任务类型 |
| 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 | 压缩包下载链接 |
请求示例
POST /koodrive/ose/v1/share/taskDetail
{
"taskId" : "1689768877770401664",
"shareId" : "1689765568237837824",
"kdstoken" : "aea2968ec8cfac338cd4647f071c44644c491d0a2039cd6c"
} 响应示例
状态码:200
OK
{
"jobInfo" : {
"userId" : "1684711050387378049",
"taskId" : "1689768877770401664",
"taskType" : 1,
"taskStatus" : 2,
"taskResultCode" : 1,
"createTime" : "20250520022907",
"startTime" : "20250520022907",
"endTime" : "20250520022907",
"progress" : 100
},
"taskInfos" : [ {
"fileId" : "Fk63FCWhcDAga2puvYKRG1oTMjs-m30sI",
"status" : "1",
"newFileId" : "FpUqGxkEf54_NeuRnzRdGmrIrzQCPnKCP",
"srcContainerId" : "IAABh_RdhS8bOg0cA1684711052660690818"
} ],
"code" : 0,
"msg" : "Success."
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |