次の方法で共有


ドライブを取得する

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

ドライブ リソースのプロパティとリレーションシップを取得します。

ドライブは、OneDrive や SharePoint ドキュメント ライブラリなどのファイル システムの最上位コンテナーです。

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

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

アクセス許可

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

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

HTTP 要求

ユーザーの現在の OneDrive を取得する

サインインしているユーザーのドライブ (委任された認証を使用する場合) には、シングルトンから me アクセスできます。

ユーザーが OneDrive のライセンスを持っていて、OneDrive がまだ設定されていない場合、委任された認証を使用すると、この要求によってユーザーのドライブが自動的にプロビジョニングされます。

GET /me/drive

ユーザーの OneDrive を取得する

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

ユーザーが OneDrive のライセンスを持っていて、OneDrive がまだ設定されていない場合、委任された認証を使用すると、この要求によってユーザーのドライブが自動的にプロビジョニングされます。

GET /users/{idOrUserPrincipalName}/drive

パス パラメーター

パラメーター名 説明
idOrUserPrincipalName string 必須。 OneDrive を所有するユーザー オブジェクトの識別子。

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

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

GET /groups/{groupId}/drive

パス パラメーター

パラメーター名 説明
groupId string 必須です。 ドキュメント ライブラリを所有するグループの識別子。

サイトのドキュメント ライブラリを取得する

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

GET /sites/{siteId}/drive

パス パラメーター

パラメーター名 説明
siteId string 必須。 ドキュメント ライブラリを含むサイトの識別子。

ID によりドライブを取得する

ドライブの一意の識別子を持っている場合、最上位ドライブのコレクションから直接アクセスできます。

GET /drives/{driveId}

パス パラメーター

パラメーター名 説明
driveId string 必須。 要求されるドライブの識別子。

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

これらのメソッドは、応答を形成するための $selectクエリ パラメーター をサポートします。

応答

各メソッドは、一致するドライブに応じた Drive リソースを応答本文で返します。

エラー応答コード

ドライブが存在せず、(委任された認証を使用するときに) 自動的にプロビジョニングできない場合は、 HTTP 404 応答が返されます。

要求

次の例は要求を示しています。

GET /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
    }
}