上载或替换 driveItem 的内容

通过简单的上载 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 /me/drive/items/{parent-id}:/{filename}:/content
PUT /me/drive/root:/{parent-path}/{filename}:/content
PUT /me/drive/items/{parent-id}/children/{filename}/content
PUT /groups/{id}/drive/items/{parent-id}/children/{filename}/content

请求正文

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

响应

如果成功,此方法在新建文件的响应正文中返回 driveItem 对象。

示例

此示例通过已登录用户的 OneDrive 路径上载文件。

PUT /me/drive/root:/{item-path}:/content
Content-type: text/plain

The contents of the file goes here.
响应

以下示例显示了相应的响应。

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

{
  "id": "0123456789abc",
  "name": "myfile.jpg",
  "size": 10191,
  "file": { }
}