ドライブを取得する

Drive リソースのプロパティと関係を取得します。ドライブは、ファイル システムの最上位のコンテナーです。Graph API を使用すると、ユーザーの OneDrive または OneDrive for Business や SharePoint ドキュメント ライブラリのドライブ リソースにアクセスできます。

前提条件

この API を実行するには、以下のいずれかのスコープが必要です。

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

ユーザーの OneDrive を取得する

ユーザーの OneDrive または OneDrive for Business にアクセスするには、User リソースについてのドライブ関係をアプリが要求する必要があります。

HTTP 要求

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

グループに関連付けられたドキュメント ライブラリを取得する

グループの既定のドキュメント ライブラリにアクセスするには、そのグループについてのドライブ関係をアプリが要求する必要があります。

HTTP 要求

GET /groups/{idOrUserPrincipalName}/drive

オプションのクエリ パラメーター

このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートします。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で Drive リソースを返します。

要求

サインインしているユーザーの 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
    }
}