Teilen über


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

GET /me/drive

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