Skip to content

Latest commit

 

History

History
71 lines (56 loc) · 1.77 KB

get.md

File metadata and controls

71 lines (56 loc) · 1.77 KB

Get metadata for a drive on OneDrive

Use the OneDrive API to get metadata for a user's drive using its unique identifier.

HTTP request

GET /drives/{drive-id}

Path parameters

Parameter name Value Description
drive-id string Required. The ID for the drive requested.

Optional query parameters

This method supports [optional query string parameters][odata-query-parameters] to shape the response.

Request body

Do not supply a request body with this method.

HTTP response

If successful, this method returns a [Drive resource][drive-resource] for the matching drive in the response body.

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

{
  "id": "0123456789abc",
  "owner": {
    "user": {
      "id": "12391913bac",
      "displayName": "Ryan Gregg"
    }
  },
  "quota": {
    "total": 1024000,
    "used": 514000,
    "remaining": 1010112,
    "deleted": 0,
    "state": "normal"
  },
  "driveType": "personal"
}

Note: The Response object is truncated for clarity. All default properties will be returned from the actual call.

Error response

See [Error responses][error-response] for more info about how errors are returned. [error-response]: ../misc/errors.md [drive-resource]: ../resources/drive.md [odata-query-parameters]: ../odata/optional-query-parameters.md