列出 driveItem 上的共享权限

  • 项目

命名空间：microsoft.graph

列出 driveItem 上的有效共享权限。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ✅

访问共享权限

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

  • 对于该项目的所有者，将返回所有共享权限。 这包括共有者。
  • 对于非所有者的调用方，仅返回适用于调用方的共享权限。
  • 对于能够创建共享权限的调用方，仅返回包含机密信息（例如 shareId 和 webUrl）的共享权限属性。

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派（工作或学校帐户） Files.Read Files.Read.All、Files.ReadWrite、Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All
委派（个人 Microsoft 帐户） Files.Read Files.Read.All、Files.ReadWrite、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

可选的查询参数

此方法支持 $selectOData 查询参数 来自定义响应。

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type application/json. 必需。
if-none-match 字符串。 如果包含此请求头，且提供的 eTag 与项中的当前 etag 不匹配，则返回 HTTP 304 Not Modified 响应。

响应

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

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

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

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

示例

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

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",
      "@deprecated.GrantedTo": "GrantedTo has been deprecated. Refer to GrantedToV2",
      "roles": ["write"],
      "grantedTo": {
        "user": {
          "id": "5D33DD65C6932946",
          "displayName": "Robin Danielsen"
        }
      },
      "grantedToV2": {
        "user": {
          "id": "5D33DD65C6932946",
          "displayName": "Robin Danielsen"
        },
        "siteUser": {
          "id": "1",
          "displayName": "Robin Danielsen",
          "loginName": "Robin Danielsen"
        }
      },
      "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 的权限关系。 必须直接访问权限属性。

错误响应

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