复制 DriveItem

在新父级下或使用新名称创建一个 driveItem 副本(包括任何子级)。

先决条件

要执行此 API,需要以下范围之一:

  • Files.ReadWrite
  • Files.ReadWrite.All
  • Sites.ReadWrite.All

HTTP 请求

POST /me/drive/items/{item-id}/copy
POST /me/drive/root:/{path}:/copy
POST /groups/{group-id}/drive/items/{item-id}/copy

请求正文

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

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

注意:_ParentReference_ 应包括 idpath,但不能同时包括两者。如果这两项都包括在内,它们需要引用相同的项,否则将发生错误。

示例

POST https://graph.microsoft.com/v1.0/me/drive/items/{item-id}/copy
Content-Type: application/json

{
  "parentReference": {
    "path": "/drive/root:/Documents"
  },
  "name": "contoso plan.docx"
}

响应

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

HTTP/1.1 202 Accepted

注解

在许多情况下,复制操作采用异步执行。API 响应仅指明复制操作获得接受还是遭到拒绝(比如说,由于目标文件名已被其他对象使用而遭到拒绝)。

注意:API 未提供用于确认复制是否成功的方法。