删除权限

删除 DriveItem 访问权限。

仅可删除非继承的权限。InheritedFrom 属性必须为 null

先决条件

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

  • Files.ReadWrite
  • Files.ReadWrite.All
  • Shares.ReadWrite.All

HTTP 请求

DELETE /me/drive/items/{item-id}/permissions/{perm-id}
DELETE /me/drive/root:/{path}:/permissions/{perm-id}
DELETE /groups/{group-id}/drive/items/{item-id}/permissions/{perm-id}
DELETE /drives/{drive-id}/items/{item-id}/permissions/{perm-id}

请求标头

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

请求正文

请勿提供此方法的请求正文。

响应

如果成功,此方法返回 204 No Content 响应代码。它不在响应正文中返回任何内容。

示例

请求

下面是一个请求示例。

DELETE https://graph.microsoft.com/v1.0/me/drive/root/items/{item-id}/permissions/{perm-id}
响应

下面是一个响应示例。

HTTP/1.1 204 No Content

注解

  • 具有 personal(OneDrive 个人版)driveType驱动器 无法创建或修改根 DriveItem 上的权限。