上传或替换 driveItem 的内容

项目
04/08/2023

通过简单上传 API，可以在一个 API 调用中提供新文件的内容或更新现有文件的内容。此方法仅支持最大大小为 4 MB 的文件。

权限

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

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

HTTP 请求（替换现有项）

PUT /drives/{drive-id}/items/{item-id}/content
PUT /groups/{group-id}/drive/items/{item-id}/content
PUT /me/drive/items/{item-id}/content
PUT /sites/{site-id}/drive/items/{item-id}/content
PUT /users/{user-id}/drive/items/{item-id}/content

HTTP 请求（上传新文件）

PUT /drives/{drive-id}/items/{parent-id}:/{filename}:/content
PUT /groups/{group-id}/drive/items/{parent-id}:/{filename}:/content
PUT /me/drive/items/{parent-id}:/{filename}:/content
PUT /sites/{site-id}/drives/{drive-id}/{parent-id}:/{filename}:/content
PUT /users/{user-id}/drive/items/{parent-id}:/{filename}:/content

请求正文

请求正文的内容应该是要上载文件的二进制流。

响应

如果成功，此方法将在新创建或更新的文件的响应正文中返回 driveItem 对象。

示例（上传新文件）

此示例将字符串“文件的内容转到此处”上传到名为 FileB.txt 的 FolderA 下的已登录用户驱动器中的文件。

PUT /me/drive/root:/FolderA/FileB.txt:/content
Content-Type: text/plain

The contents of the file goes here.

响应

如果成功，此方法将在响应正文中返回新建文件的 driveItem 资源。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

示例（更新现有文件）

此示例将文件的内容替换为已知 ID。

PUT /me/drive/items/{item-id}/content
Content-Type: text/plain

The contents of the file goes here.

响应

如果成功，此方法将在响应正文中返回新建文件的 driveItem 资源。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

注解

被阻止的文件类型

SharePoint Server 2016 阻止将具有下面几个文件扩展名的文件上传到服务器。

.ashx - ASP.NET Web 处理程序文件
.asmx - ASP.NET Web 服务源文件
.json - JavaScript 对象表示法文件
.soap - 简单对象访问协议文件
.svc - Windows Communication Foundation (WCF) 服务文件
.xamlx - Visual Studio 工作流服务文件

请参阅添加到列表或库的文件的类型有关阻止的文件扩展名详细信息。

冲突解决行为

默认情况下，此 API 将替换同名的现有项。若要自定义冲突解决行为，请将名为@microsoft.graph.conflictBehavior 的查询参数与失败、替换或重命名的值添加到请求。

错误响应

请参阅错误响应，详细了解错误返回方式。

通过