拷贝文件或目录。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /v2/file/copy HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| domain_id |
string |
是 |
||
| body |
object |
否 |
请求体参数。 |
|
| share_id |
string |
否 |
分享 id。
如果通过分享操作文件,请携带 |
7JQX1FswpQ8 |
| drive_id |
string |
否 |
空间 id |
1 |
| file_id |
string |
是 |
文件或文件夹 id |
4221bf6e6ab43c255edc4463bf3a6f5f5d317406 |
| to_drive_id |
string |
否 |
拷贝到的空间 id。 默认值同 drive_id。 |
1 |
| to_parent_file_id |
string |
是 |
目的父文件夹 id,当复制进根目录时,填 root |
6520943DC261 |
| auto_rename |
boolean |
否 |
当目标文件夹下存在同名文件时,是否自动重命名,默认为 false |
true |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| domain_id |
string |
域 id |
bj1 |
| drive_id |
string |
空间 id |
1 |
| file_id |
string |
复制后的新文件或文件夹 id |
4221bf6e6ab43a255edc4463bffa6f5f5d317401 |
| async_task_id |
string |
异步任务 id。 当复制的是文件时,不返回该字段;当复制的是文件夹时,为后台异步复制,会返回该字段,调用 GetAsyncTask,传递异步任务 id,获取任务信息。 |
000e89fb-cf8f-11e9-8ab4-b6e980803a3b |
示例
正常返回示例
JSON格式
{
"domain_id": "bj1",
"drive_id": "1",
"file_id": "4221bf6e6ab43a255edc4463bffa6f5f5d317401",
"async_task_id": "000e89fb-cf8f-11e9-8ab4-b6e980803a3b"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。