文档首页/云空间服务 KooDrive/API参考/API/批量任务操作/创建批量任务 - CreateJob
更新时间：2026-02-03 GMT+08:00
查看PDF
分享

创建批量任务 - CreateJob

功能介绍

创建一个批量任务。

授权信息

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

URI

POST /koodrive/ose/v1/jobs

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token}

X-User-Id

是

String

用户id，用于app鉴权

X-Date

是

String

日期，用于app鉴权

Host

是

String

地址，用于app鉴权

X-Traceid

否

String

消息日志跟踪标识(必须58位)

language

否

String

国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语

x-hw-share-folder-id

否

String

参数解释：

共享文件夹ID。如果传入了该请求头，则说明当前的操作是在共享文件夹内。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

表2 请求Body参数

参数

是否必选

参数类型

描述

taskType

是

Integer

任务类型，枚举值：

  • 1：批量复制任务

  • 2：批量删除任务

  • 3：批量移动任务

  • 4：批量还原回收站

  • 5：云解压

  • 6：打包下载

  • 7：清空回收站（该功能目前只有白名单用户使用）

actionType

否

Integer

操作类型，对taskType的细分。仅在taskType为1、2、3时使用

  • 101：复制和转存

  • 201：逻辑删除（移入回收站）

  • 202：彻底删除

  • 301：普通移动

  • 501：查看压缩包

  • 502：全部解压

  • 503：部分解压

  • 701：清空回收站（该功能目前只有白名单用户使用）

taskInfo

是

CreateTaskInfoReq object

创建批量任务请求

dstContainerId

是

String

目标空间ID

password

否

String

压缩包密码

表3 CreateTaskInfoReq

参数

是否必选

参数类型

描述

fileInfo

是

Array of fileInfo objects

文件/目录ID（taskType为7时可以不传）

newFilePath

否

String

操作文件变更后的新路径（taskType为7时可以不传）

srcContainerId

是

String

源空间的标识

uncompressFilePaths

否

Array of strings

部分解压的文件在压缩包内的全路径列表

表4 fileInfo

参数

是否必选

参数类型

描述

fileId

否

String

文件标识（只有7清空回收站不填）

filePath

否

String

文件全路径，包含fileId(逻辑删除，即移入回收站是必填，影响还原功能)

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

code

String

错误码

msg

String

错误信息

data

String

任务id

状态码：400

表6 响应Body参数

参数

参数类型

描述

code

String

响应码

msg

String

响应描述

状态码：401

表7 响应Body参数

参数

参数类型

描述

code

String

响应码

msg

String

响应描述

状态码：500

表8 响应Body参数

参数

参数类型

描述

code

String

响应码

msg

String

响应描述

请求示例

批量复制文件请求示例。

POST /koodrive/ose/v1/jobs

Authorization:Bearer+10f88d07fa************44791e9ff
{
    "taskType":1 ,
    "actionType":101 ,
    "dstContainerId": "IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4" ，
    "taskInfo": {
        "srcContainerId": "IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4"，
        "newFilePath": "Fm9UdqBNTAQDos6l1xPlFnIqXJg2-UdqA" ，
        "fileInfo": [
            {
                "fileId": "FuZmQ66CF0DdpKRG1Y29Iwajbq04Nhwu3"  
            }
       
        ]
    }
}

响应示例

状态码：200

基础响应，只返回错误码和错误信息

{
    "data": "1309243162258308352"
    "code": 0,
    "msg": "success"
}

状态码

状态码

描述

200

基础响应，只返回错误码和错误信息

400

错误响应

401

鉴权失败

500

内部错误

父主题：批量任务操作

相关文档