调用CopyFile复制文件或文件夹_网盘与相册服务(PDS)-阿里云帮助中心

拷贝文件或目录。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST /v2/file/copy HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求体参数。
share_id	string	否	分享 id。如果通过分享操作文件，请携带`x-share-token` header 鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。 `share_id`和`drive_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"
}

错误码

访问错误中心查看更多错误码。