批量复制文件或文件夹新版SDK
更新于 2023-06-06调用本接口，批量复制文件或文件夹。
接口功能介绍
调用本接口可实现以下操作：
-
批量复制文件至其他空间或目录。
-
批量复制文件夹至其他空间或目录。
权限
要调用此API，需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
|---|---|---|---|
| 企业内部应用 | 支持 | 企业存储文件写权限 | API Explorer |
| 第三方企业应用 | 支持 | 企业存储文件写权限 | API Explorer |
| 第三方个人应用 | 暂不支持 | 企业存储文件写权限 | 暂不支持 |
请求方法
Header参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。
|
Path参数
Query参数
Body参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
targetSpaceId | String | 是 | 目标文件或文件夹所在的空间ID。 |
targetFolderId | String | 是 | 目标文件夹ID， 根目录ID值为0。
|
dentryIds | Array of String | 是 | 源文件或文件夹的ID列表，最大值30。
|
option | Object | 否 | 可选参数。 |
conflictStrategy | String | 否 | 文件或者文件夹的名称冲突策略。
|
返回参数
名称 | 类型 | 描述 |
|---|---|---|
resultItems | Array | 批量复制文件或文件夹的结果列表。 |
spaceId | String | 源文件或文件夹所在的空间ID。 |
dentryId | String | 源文件或文件夹的ID。 |
async | Boolean | 是否是异步任务。
说明
如果操作的文件夹有子节点，则会异步处理。 |
success | Boolean | 是否成功。
说明
如果是异步任务，该字段不返回。 |
errorCode | String | 错误原因。 说明
如果是异步任务，该字段不返回。 |
taskId | String | 异步任务ID，可用于查询任务执行状态。
|
targetSpaceId | String | 目标空间ID。 说明
非失败情况下，同步或异步都会返回。 |
targetDentryId | String | 复制之后的文件或文件夹ID。 说明
非失败情况下，同步或异步都会返回。 |
示例
请求示例
返回示例
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | operationConcurrentControl | %s | 并发控制 |
400 | paramError | %s | 参数错误 |
400 | paramError.spaceId | %s | 参数错误-spaceId |
400 | paramError.dentryIds | %s | 参数错误-dentryIds |
400 | paramError.targetSpaceId | %s | 参数错误-targetSpaceId |
400 | paramError.targetFolderId | %s | 参数错误-targetFolderId |
400 | paramError.conflictStrategy | %s | 参数错误-conflictStrategy |
400 | spaceQuotaInsufficient | %s | 空间容量不足 |
400 | sceneQuotaInsufficient | %s | 场景容量不足 |
400 | appQuotaInsufficient | %s | 应用容量不足 |
400 | orgQuotaInsufficient | %s | 企业容量不足 |
400 | dentryAlreadyExist | %s | 同名文件已存在 |
403 | permissionDenied | %s | 用户缺少拷贝文件(夹)的权限 |
404 | spaceNotExist | %s | 源文件(夹)或目标目录所在空间不存在 |
404 | dentryNotExist | %s | 源文件(夹)或目标目录不存在 |
500 | systemError | %s | 系统错误 |
500 | unknownError | Unknown Error | 未知错误 |
503 | operationTimeout | %s | 请求超时 |
