获取驱动器

检索 驱动器 资源的属性和关系。Drive 是文件系统的顶级容器。Graph API 允许访问用户 OneDrive/OneDrive for Business 或 SharePoint 文档库的 Drive 资源。

先决条件

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

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

获取用户的 OneDrive

若要访问用户的 OneDrive 或 OneDrive for Business,应用必须请求对 User 资源获取 drive 关系。

HTTP 请求

GET /me/drive
GET /users/{idOrUserPrincipalName}/drive

获取与组关联的文档库

若要访问的默认文档库,你的应用程序应请求组中的驱动器关系。

HTTP 请求

GET /groups/{idOrUserPrincipalName}/drive

可选的查询参数

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

请求正文

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

响应

如果成功,此方法在响应正文中返回 200 OK 响应代码和 驱动器 资源。

示例

请求

下面是一个请求获取已登录用户的 OneDrive 或 OneDrive for Business 的示例。

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

下面是一个响应示例。

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

{
    "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
    }
}