上载或替换 driveItem 的内容

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

若要上载大文件,请参阅 通过上载会话上载大文件

先决条件

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

  • Files.ReadWrite
  • 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": { }
}