复制 DriveItem

以异步方式在新父项下或使用新名称创建一个 driveItem 副本（包括任何子项）。

权限

调用此 API 需要以下权限之一。 若要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	Files.ReadWrite、Files.ReadWrite.All、Sites.ReadWrite.All
委派（个人 Microsoft 帐户）	Files.ReadWrite、Files.ReadWrite.All
应用程序	Files.ReadWrite.All、Sites.ReadWrite.All

HTTP 请求

POST /drives/{driveId}/items/{itemId}/copy
POST /groups/{groupId}/drive/items/{itemId}/copy
POST /me/drive/items/{item-id}/copy
POST /sites/{siteId}/drive/items/{itemId}/copy
POST /users/{userId}/drive/items/{itemId}/copy

请求正文

在请求正文中，提供具有以下参数的 JSON 对象。

名称	值	说明
parentReference	ItemReference	可选。 引用在其中创建副本的父项。
name	string	可选。 副本的新名称。 如果未提供新名称，将同一名称用作原始名称。

注意：parentReference 应包括目标文件夹的 driveId 和 id 参数。

示例

本示例将由 {item-id} 标识的文件复制到使用 driveId 和 id 值标识的文件夹。 该文件的新副本将被命名为 contoso plan (copy).txt。

POST /me/drive/items/{item-id}/copy
Content-Type: application/json

{
  "parentReference": {
    "driveId": "6F7D00BF-FC4D-4E62-9769-6AEA81F3A21B",
    "id": "DCD0D3AD-8989-4F23-A5A2-2C086050513F"
  },
  "name": "contoso plan (copy).txt"
}

响应

返回有关如何在接受请求时监视复制操作进度的详细信息。

HTTP/1.1 202 Accepted
Location: https://contoso.sharepoint.com/_api/v2.0/monitor/4A3407B5-88FC-4504-8B21-0AABD3412717

Location 头值提供的服务 URL 将返回复制操作的最新状态。 可以根据此信息确定复制操作完成时间。

注解

在许多情况下，异步执行复制操作。 由于目标文件名已在使用中，来自 API 的响应仅指示复制操作已被接受还是拒绝。