利用可能なドライブの一覧表示

  • [アーティクル]

名前空間: microsoft.graph

ターゲットとなる User、Group、または Site が利用可能な Drive リソースの一覧を取得します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ✅ ✅ ✅

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) Files.Read Files.Read.All、Files.ReadWrite、Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All
委任 (個人用 Microsoft アカウント) Files.Read Files.Read.All、Files.ReadWrite、Files.ReadWrite.All
アプリケーション Files.Read.All Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All

HTTP 要求

グループのドライブを一覧表示する

グループのドキュメント ライブラリを一覧表示するために、アプリが Group の drives リレーションシップを要求します。

GET /groups/{groupId}/drives

サイトのドライブを一覧表示する

サイトのドキュメント ライブラリを一覧表示するために、アプリは Site の drives リレーションシップを要求します。

GET /sites/{siteId}/drives

ユーザーのドライブを一覧表示する

GET /users/{userId}/drives

現在のユーザーのドライブを一覧表示する

GET /me/drives

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

このメソッドは、応答を$expandカスタマイズするために、$select$skipToken、$topおよび $orderbyOData クエリ パラメーターをサポートします。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で Drive オブジェクトのコレクションを返します。

例

要求

GET /me/drives

応答

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#drives",
    "value": [
        {
            "createdDateTime": "2017-07-27T02:41:36Z",
            "description": "",
            "id": "b!-RIj2DuyvEyV1T4NlOaMHk8XkS_I8MdFlUCq1BlcjgmhRfAj3-Z8RY2VpuvV_tpd",
            "lastModifiedDateTime": "2018-03-27T07:34:38Z",
            "name": "OneDrive",
            "webUrl": "https://m365x214355-my.sharepoint.com/personal/meganb_m365x214355_onmicrosoft_com/Documents",
            "driveType": "business",
            "createdBy": {
                "user": {
                    "displayName": "System Account"
                }
            },
            "lastModifiedBy": {
                "user": {
                    "email": "MeganB@contoso.com",
                    "id": "48d31887-5fad-4d73-a9f5-3c356e68a038",
                    "displayName": "Megan Bowen"
                }
            },
            "owner": {
                "user": {
                    "email": "MeganB@contoso.com",
                    "id": "48d31887-5fad-4d73-a9f5-3c356e68a038",
                    "displayName": "Megan Bowen"
                }
            },
            "quota": {
                "deleted": 0,
                "remaining": 1099217021300,
                "state": "normal",
                "total": 1099511627776,
                "used": 294606476
            }
        }
    ]
}

備考

ほとんどのユーザーには、ドライブ リソースが 1 つしかありません。

Group と Site には、複数の Drive リソースが利用可能である場合があります。

system ファセットのあるドライブは既定では非表示です。 それらを一覧表示するには、$select ステートメントに system を含めます。