Laufwerk abrufen

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.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Anwendung	Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

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 ist, der Benutzer jedoch über eine Lizenz für OneDrive verfügt, wird über diese Anforderung das Laufwerk des Benutzers automatisch bereitgestellt, wenn eine delegierte Authentifizierung verwendet wird.

HTTP-Anforderung

GET /me/drive

Wenn Sie den direkten OneDrive-Dienstendpunkt verwenden, lassen Sie das Segment /me aus.

GET /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 ist, der Benutzer jedoch über eine Lizenz für OneDrive verfügt, wird über diese Anforderung das Laufwerk des Benutzers automatisch bereitgestellt, wenn eine delegierte Authentifizierung verwendet wird.

HTTP-Anforderung

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.

HTTP-Anforderung

GET /groups/{groupId}/drive

Pfadparameter

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

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.

HTTP-Anforderung

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.

HTTP-Anforderung

GET /drives/{drive-id}

Pfadparameter

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

Optionale Abfrageparameter

Diese Methode unterstützt die $select-Abfrageparameter zum Modellieren der Antwort.

HTTP-Antwort

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

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,
        "fileCount": 2,
        "remaining": 1099447353539,
        "state": "normal",
        "total": 1099511627776
    }
}

Fehlerantwortcodes

Wenn das Laufwerk nicht vorhanden ist und nicht automatisch bereitgestellt werden kann (wenn die delegierte Authentifizierung verwendet wird), wird eine HTTP 404-Antwort zurückgegeben.