author: rgregg ms.author: rgregg ms.date: 09/10/2017 title: "删除对项的访问权限" ms.openlocfilehash: cf573b49edc326ca221545657b29b1f2e86ba417 ms.sourcegitcommit: 7aea7a97e36e6d146214de3a90fdbc71628aadba ms.translationtype: HT ms.contentlocale: zh-CN

ms.lasthandoff: 09/28/2017

从文件或文件夹中删除共享权限

删除对 DriveItem 的访问权限。

只能删除继承的共享权限。 InheritedFrom 属性必须为 null

权限

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

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

HTTP 请求

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

可选的请求标头

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

响应

如果成功,此方法返回 204 No Content 响应代码。

示例

本示例从当前用户 OneDrive 的项 {item-id} 中删除标识为 {perm-id} 的权限。

DELETE /me/drive/root/items/{item-id}/permissions/{perm-id}

响应

HTTP/1.1 204 No Content

注解

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