更新共享权限

通过修补 permission 资源更新共享权限的属性。

只有 roles 属性可以通过这种方式修改。

权限

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

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

HTTP 请求

PATCH /drives/{drive-id}/items/{item-id}/permissions/{perm-id}
PATCH /groups/{group-id}/drive/items/{item-id}/permissions/{perm-id}
PATCH /me/drive/items/{item-id}/permissions/{perm-id}
PATCH /sites/{site-id}/drive/items/{item-id}/permissions/{perm-id}
PATCH /users/{user-id}/drive/items/{item-id}/permissions/{perm-id}

可选的请求标头

名称	类型	说明
if-match	string	如果包含此请求标头，且提供的 eTag（或 cTag）与项中的当前标记不匹配，则返回 412 Precondition Failed 响应，并且不会删除该项。

请求正文

在请求正文中，提供应更新的相关字段的值。

请求正文中不包括的现有属性将保留其以前的值，或根据对其他属性值的更改重新计算。 为了实现最佳性能，不得添加未变化的现有值。

属性	类型	说明
角色	String 集合	权限类型的数组。

响应

如果成功，此方法在响应正文中返回 200 OK 响应代码和更新的 permission 对象。

示例

下面是请求将共享权限上的角色更改为只读的示例。

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

{
  "roles": [ "read" ]
}

响应

如果成功，此方法将在响应正文中返回 Permission 资源，表示请求获取的更新后权限状态。

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

{
  "grantedTo": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "efee1b77-fb3b-4f65-99d6-274c11914d12"
    }
  },
  "id": "1",
  "roles": [ "read" ]
}

错误响应

请阅读 错误响应 主题，了解有关如何返回错误的详细信息。