列出可用的驱动器

检索可用于目标 用户驱动器 资源的列表。你的应用程序也可以请求 SharePoint 根网站上的文档库集。

先决条件

要执行此 API,需要以下范围之一:

  • Files.Read
  • Files.ReadWrite
  • Sites.Read.All

HTTP 请求

GET /drives
GET /me/drives
GET /sites/{site-id}/drives

可选的查询参数

此方法支持 OData 查询参数 来帮助自定义响应。

请求正文

请勿提供此方法的请求正文。

响应

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

示例

请求

下面是一个请求用户驱动器的示例。

GET https://graph.microsoft.com/v1.0/me/drives
响应

下面是一个响应示例。

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

{
  "value": [
    {
      "id": "b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7",
      "driveType": "business",
      "owner": {
          "user": {
              "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
              "displayName": "Ryan Gregg"
          }
      },
      "quota": {
          "deleted": 256938,
          "remaining": 1099447353539,
          "state": "normal",
          "total": 1099511627776
      }
    }
  ]
}

注解

大多数用户将只有一个驱动器资源。组和部分用户可能有多个驱动器可用。