Laufwerk abrufen

Namespace: microsoft.graph

Ruft die Eigenschaften und Beziehungen einer Laufwerksressource ab.

Ein Laufwerk ist der Container auf oberster Ebene für ein Dateisystem, z. B. OneDrive- oder SharePoint-Dokumentbibliotheken.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

HTTP-Anforderung

Abrufen des aktuellen OneDrive eines Benutzers

Auf das Laufwerk des angemeldeten Benutzers (bei Verwendung der delegierten Authentifizierung) kann über das me Singleton zugegriffen werden.

Wenn ein Benutzer über eine Lizenz für OneDrive verfügt, sein OneDrive aber noch nicht eingerichtet ist, stellt diese Anforderung bei Verwendung der delegierten Authentifizierung automatisch das Laufwerk des Benutzers bereit.

GET /me/drive

Abrufen des OneDrive eines Benutzers

Damit Sie auf OneDrive oder OneDrive for Business eines Benutzers zugreifen können, muss Ihre App die drive-Beziehung in der User-Ressource anfordern.

Wenn ein Benutzer über eine Lizenz für OneDrive verfügt, sein OneDrive aber noch nicht eingerichtet ist, stellt diese Anforderung bei Verwendung der delegierten Authentifizierung automatisch das Laufwerk des Benutzers bereit.

GET /users/{idOrUserPrincipalName}/drive

Pfadparameter

Dient zum Abrufen der Dokumentbibliothek, die einer Gruppe zugeordnet ist.

Für den Zugriff auf die Standarddokumentbibliothek einer Gruppe fordert Ihre App die drive-Beziehung in der Gruppe an.

GET /groups/{groupId}/drive

Pfadparameter

Abrufen der Dokumentbibliothek für eine Website

Für den Zugriff auf die Standarddokumentbibliothek einer Website fordert Ihre App die drive-Beziehung auf der Website an.

GET /sites/{siteId}/drive

Pfadparameter

Abrufen eines Laufwerks nach ID

Wenn Sie die eindeutige ID für ein Laufwerk besitzen, können Sie direkt über die Websitesammlung auf oberster Ebene darauf zugreifen.

GET /drives/{driveId}

Pfadparameter

Optionale Abfrageparameter

Diese Methoden unterstützen den $select-Abfrageparameter , um die Antwort zu strukturieren.

Antwort

Diese Methoden geben eine Drive-Ressource für das entsprechende Laufwerk im Antworttext zurück.

Fehlerantwortcodes

Wenn das Laufwerk nicht vorhanden ist und nicht automatisch bereitgestellt werden kann (bei Verwendung der delegierten Authentifizierung), wird eine HTTP 404 Antwort zurückgegeben.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET /me/drive

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.Drive.GetAsync();

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
drive, err := graphClient.Me().Drive().Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Drive result = graphClient.me().drive().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let drive = await client.api('/me/drive')
	.version('beta')
	.get();

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->me()->drive()->get()->wait();

Import-Module Microsoft.Graph.Beta.Files

# A UPN can also be used as -UserId.
Get-MgBetaUserDefaultDrive -UserId $userId

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.me.drive.get()

Antwort

Das folgende Beispiel zeigt die Antwort.

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