列出 DriveItem 中的共享权限

列出 DriveItem 中的有效共享权限。

访问共享权限

权限集合包括潜在的敏感信息,未必适用于所有调用方。

  • 对于该项目的所有者,将返回所有共享权限。这也包括共有者。
  • 对于非所有者的调用方,仅返回适用于调用方的共享权限。
  • 对于能够创建共享权限的调用方,仅返回包含机密信息(例如 shareIdwebUrl)的共享权限属性。

权限

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

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

HTTP 请求

GET /drives/{drive-id}/items/{item-id}/permissions
GET /groups/{group-id}/drive/items/{item-id}/permissions
GET /me/drive/items/{item-id}/permissions
GET /me/drive/root:/{path}:/permissions
GET /sites/{siteId}/drive/items/{itemId}/permissions
GET /users/{userId}/drive/items/{itemId}/permissions

可选的查询参数

此方法支持使用 $select OData 查询参数自定义响应。

可选的请求标头

名称 类型 说明
if-none-match string 如果包含此请求头,且提供的 eTag 与项中的当前 etag 不匹配,则返回 HTTP 304 Not Modified 响应。

响应

如果成功,此方法在响应正文中返回 200 OK 响应代码和 权限 资源集合。

DriveItem 的有效共享权限可能有两个来源:

  • 直接对 DriveItem 本身应用的共享权限
  • 从 DriveItem 的上级继承的共享权限

调用方可以通过检查 inheritedFrom 属性来区分是否为继承权限。此属性是引用从中继承该权限的上级的 itemReference 资源。

对项设置的 SharePoint 权限级别在返回时包含“SP”前缀。 例如,SP.View Only、SP.Limited Access、SP.View Web Analytics Data。 请参阅 SharePoint 角色完整列表

示例

本示例检索登录用户驱动器中某个项的权限集合。

GET /me/drive/items/{item-id}/permissions

响应

此示例响应包括三个权限,第一个是具有编辑权限的共享链接,第二个是继承自父文件夹且用户名为 John 的显式权限,第三个是由一个应用程序创建的读写共享链接。

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

{
  "value": [
    {
      "id": "1",
      "roles": ["write"],
      "link": {
        "webUrl": "https://onedrive.live.com/redir?resid=5D33DD65C6932946!70859&authkey=!AL7N1QAfSWcjNU8&ithint=folder%2cgif",
        "type": "edit"
      }
    },
    {
      "id": "2",
      "roles": ["write"],
      "grantedTo": {
        "user": {
          "id": "5D33DD65C6932946",
          "displayName": "John Doe"
        }
      },
      "inheritedFrom": {
        "driveId": "1234567890ABD",
        "id": "1234567890ABC!123",
        "path": "/drive/root:/Documents" }
    },
    {
      "id": "3",
      "roles": ["write"],
      "link": {
        "webUrl": "https://onedrive.live.com/redir?resid=5D33DD65C6932946!70859&authkey=!AL7N1QAfSWcjNU8&ithint=folder%2cgif",
        "type": "edit",
        "application": {
          "id": "12345",
          "displayName": "Contoso Time Manager"
        }
      }
    }
  ]
}

备注

不能在 获取 DriveItem 的调用过程中或 DriveItem 集合中扩展 DriveItem 的 权限 关系。必须直接访问权限属性。

错误响应

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