Laufwerk abrufen

Namespace: microsoft.graph

Dient zum Abrufen der Eigenschaften und der Beziehungen einer Drive-Ressource.

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

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

Globaler Dienst	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	✅

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	Files.Read	Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All, User.Read
Delegiert (persönliches Microsoft-Konto)	Files.Read	Files.Read.All, Files.ReadWrite, Files.ReadWrite.All
Anwendung	Nicht unterstützt	Nicht unterstützt

HTTP-Anforderung

Abrufen des OneDrive des aktuellen Benutzers

Über den me-Singleton kann auf das Laufwerk des angemeldeten Benutzers (bei der Verwendung einer delegierten Authentifizierung) zugegriffen werden.

Wenn das OneDrive eines Benutzers nicht bereitgestellt wird, der Benutzer aber über eine Lizenz für die Verwendung von OneDrive verfügt, 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 das OneDrive eines Benutzers nicht bereitgestellt wird, der Benutzer aber über eine Lizenz für die Verwendung von OneDrive verfügt, stellt diese Anforderung bei Verwendung der delegierten Authentifizierung automatisch das Laufwerk des Benutzers bereit.

GET https://graph.microsoft.com/v1.0/users/{idOrUserPrincipalName}/drive

Pfadparameter

Parametername	Wert	Beschreibung
idOrUserPrincipalName	string	Erforderlich. Der Bezeichner für das Benutzerobjekt, dem OneDrive angehört.

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

Parametername	Wert	Beschreibung
groupId	string	Erforderlich. Der Bezeichner für die Gruppe, die besitzer der Dokumentbibliothek ist.

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

Parametername	Wert	Beschreibung
siteId	string	Erforderlich. Der Bezeichner für die Website, die die Dokumentbibliothek enthält.

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

Parametername	Wert	Beschreibung
driveId	string	Erforderlich. Dies ist der Bezeichner des angeforderten Laufwerks.

Optionale Abfrageparameter

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

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.

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

HTTP

GET /me/drive

C#

// 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();

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

CLI

mgc users drive get --user-id {user-id}

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Go

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

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-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)

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Java

// 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();

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

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

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;


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


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

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

PowerShell

Import-Module Microsoft.Graph.Files

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

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph 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()

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

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