列出可用的驱动器

项目
04/08/2023

检索可用于目标用户、组或站点的 Drive 资源列表。

权限

要调用此 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

列出组的驱动器

若要列出某个组的文档库，应用应请求组中的 drives 关系。

HTTP 请求

GET /groups/{groupId}/drives

列出站点的驱动器

若要列出某个站点的文档库，应用应请求站点中的 drives 关系。

GET /sites/{siteId}/drives

列出用户的驱动器

GET /users/{userId}/drives

列出当前用户的驱动器

GET /me/drives

可选的查询参数

此方法支持、$expand$select、、 $skipToken$top和 $orderbyOData 查询参数来自定义响应。

响应

如果成功，此方法在响应正文中返回 200 OK 响应代码和 Drive 对象集合。

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

{
  "value": [
    {
      "id": "942CAEB0-13AE-491B-85E4-7557CDC0F25F",
      "driveType": "documentLibrary",
      "name": "Shared Documents",
      "owner": {
        "user": {
          "id": "AE2A1EE9-81A7-423C-ABE4-B945F47509BB",
          "displayName": "Ryan Gregg"
        }
      }
    },
    {
      "id": "C1CD3ED9-0E98-4B0B-82D3-C8FB784B9DCC",
      "driveType": "documentLibrary",
      "name": "Contoso Project Files",
      "owner": {
        "user": {
          "id": "406B2281-18E8-4416-9857-38C531B904F1",
          "displayName": "Daron Spektor"
        }
      }
    }
  ]
}

备注

大多数用户将只有一个 Drive 资源。

组和站点可使用多个 Drive 资源。

默认情况下将隐藏包含 system Facet 的 Drive。若要列出它们，请在 $select 语句中包含 system。

通过