创建分享异步任务 - createBatchTask
功能介绍
创建分享异步任务。
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/share/tasks
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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分钟以内,不能晚于当前时间 取值范围: 不涉及 默认值: 不涉及 |
X-Hw-Agentname | 是 | String | 参数解释: 运营商名称 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
taskType | 是 | Integer | 参数解释: 批量操作任务类型 约束限制: 不涉及 取值范围: 默认值: 不涉及 |
containerId | 是 | String | 参数解释: 文件所在空间 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
fileIds | 是 | Array of strings | 参数解释: 文件id列表 约束限制: 包含的文件ID数量最少1个,最多1000个 取值范围: 不涉及 默认值: 不涉及 |
targetFileId | 否 | FileIdInfo object | 参数解释: 目标目录信息,当目标目录是根目录时,fileId应该传"root" 约束限制: taskType=2时必填 取值范围: 不涉及 默认值: 不涉及 |
zipName | 否 | String | 参数解释: 压缩包名称 约束限制: taskType=1时必填 取值范围: 不涉及 默认值: 不涉及 |
shareId | 是 | String | 参数解释: 分享id 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
kdstoken | 否 | String | 参数解释: 分享临时token 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
code | Integer | 响应码 |
msg | String | 响应信息 |
taskId | String | 任务id |
请求示例
POST /koodrive/ose/v1/share/tasks
{
"taskType" : 2,
"containerId" : "IAABh_RdhS8bOg0cA1684711052660690818",
"fileIds" : [ "Fk63FCWhcDAga2puvYKRG1oTMjs-m30sI" ],
"shareId" : "1689765568237837824",
"kdstoken" : "aea2968ec8cfac338cd4647f071c44644c491d0a2039cd6c",
"targetFileId" : {
"fileId" : "FhTB_fxx3LRszaivDFX9NN5JRNLnS9Gob",
"containerId" : "IAABh_RdhS8bOg0cA1684711052660690818"
}
} 响应示例
状态码:200
OK
{
"code" : 0,
"msg" : "Success",
"taskId" : "1689765568237837824"
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |

