如何通过Microsoft Graph跨不同Drive移动文件而非复制？

微软Graph API目前没有原生支持跨Drive直接移动文件的接口，driveitem-move仅局限于同一Drive内操作。要实现跨Drive的“移动”效果，只能通过复制+删除的组合流程来模拟，以下是具体实现步骤和注意事项：

核心实现流程 #

1. 复制文件到目标Drive #

调用driveitem-copy API将源文件复制到目标Drive的FilesFolder中，该API支持跨Drive操作。请求示例如下：

POST /drives/{X}/items/{sourceFileItemId}/copy
Content-Type: application/json

{
  "parentReference": {
    "driveId": "{Y}",
    "id": "{targetFilesFolderItemId}"
  },
  "name": "目标文件名（可与原文件名一致）"
}

该请求会返回202 Accepted状态码，响应头的Location字段会提供一个任务状态查询URL，用于跟踪复制进度。

2. 等待复制完成 #

由于复制是异步操作，需要轮询上述Location URL的状态，直到返回200 OK且任务状态为成功，确认文件已完成复制。

3. 删除源文件 #

复制完成后，调用driveitem-delete API删除原Drive中的文件：

DELETE /drives/{X}/items/{sourceFileItemId}

关键注意事项 #

• 权限要求：需要同时拥有源Drive的Files.ReadWrite权限和目标Drive的Files.ReadWrite权限。
• 原子性问题：该组合流程并非原子操作，若复制完成后删除失败，会导致文件同时存在于两个Drive中，需额外处理异常回滚逻辑。
• 版本历史：跨Drive复制不会保留原文件的版本历史记录，若需保留版本，需单独导出版本后再上传。
• 大文件处理：对于超过4MB的文件，Graph API会自动使用分块复制逻辑，无需额外处理，但需注意超时设置。

替代方案（同一租户内SharePoint场景） #

如果是同一租户下的SharePoint站点库之间移动文件，可以使用PnP PowerShell的Move-PnPFile命令，该命令封装了复制+删除的流程，且处理了异步状态检查，更简便可靠：

Move-PnPFile -SourceUrl "https://yourtenant.sharepoint.com/sites/sourceSite/Shared%20Documents/yourfile.docx" -TargetUrl "https://yourtenant.sharepoint.com/sites/targetSite/Shared%20Documents/yourfile.docx" -Force

内容的提问来源于stack exchange，提问作者W.Ghaz