更新 DriveItem 属性

按 ID 或路径更新 DriveItem 元数据。

还可以通过更新项的 parentReference 属性,使用更新将 项移动到 其他父级。

先决条件

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

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

HTTP 请求

PATCH /me/drive/items/{item-id}
PATCH /me/drive/root:/{item-path}
PATCH /drives/{drive-id}/items/{item-id}
PATCH /groups/{group-id}/drive/items/{item-id}

请求标头

名称 类型 说明
if-match String 如果包含此请求标头,且提供的 eTag(或 cTag)与文件夹上的当前 eTag 不匹配,则返回 412 Precondition Failed 响应。

请求正文

在请求正文中,提供应更新的属性的值。请求正文中不包括的现有属性将保留其以前的值,或根据对其他属性值的更改重新计算。为了获得最佳性能,应用不应包括尚未更改的属性。

响应

如果成功,此方法在响应正文中返回 200 OK 响应代码和更新的 DriveItem 资源。

示例

此示例重命名 driveItem。

PATCH /me/drive/items/{item-id}
Content-type: application/json

{
    "name": "new-file-name.docx"
}

响应

下面是一个响应示例。为提高可读性,此响应被截断。

HTTP/1.1 200 OK
Content-type: application/json

{
    "id": "01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK",
    "name": "new-file-name.docx",
    "file": { }
}