author: rgregg ms.author: rgregg ms.date: 09/10/2017 title: "列出驱动器" ms.openlocfilehash: 84771e589a65d11fc06707eb01b6211cf90a8581 ms.sourcegitcommit: 7aea7a97e36e6d146214de3a90fdbc71628aadba ms.translationtype: HT ms.contentlocale: zh-CN

ms.lasthandoff: 09/28/2017

列出可用的驱动器

检索可用于目标用户、组或站点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$orderby OData 查询参数自定义响应。

响应

如果成功,此方法在响应正文中返回 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