Freigeben über


Laufwerk abrufen

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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.

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

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.

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

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