获取文件或文件夹的共享权限

  • 项目

返回特定 permission 资源的有效共享权限。

项的有效权限有两个来源：直接对项本身设置权限，或从项上级继承权限。

调用方可以检查 inheritedFrom 属性来区分是否为继承权限。 此属性是引用继承其权限的上级的 ItemReference 资源。

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

权限

调用此 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/{perm-id}
GET /groups/{group-id}/drive/items/{item-id}/permissions/{perm-id}
GET /me/drive/items/{item-id}/permissions/{perm-id}
GET /sites/{site-id}/drive/items/{item-id}/permissions/{perm-id}
GET /users/{user-id}/drive/items/{item-id}/permissions/{perm-id}

可选的查询参数

此方法支持 $select 查询参数塑造响应。

响应

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

示例

请求

下面是请求访问某个文件夹权限的示例。

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

响应

如果成功，此方法将返回特定 ID 的 Permission 资源。

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

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

注解

权限 资源使用 facet 提供有关由该资源表示的权限类型的信息。

具有 链接 facet 的权限表示在该项上创建的共享链接。 共享链接包含一个唯一令牌，可以为具有上述链接的任何人提供对项目的访问权限。

具有 invitation facet 的权限表示通过邀请特定用户或组访问该文件添加的权限。

错误响应

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