Verfügbare Laufwerke auflisten

Dient zum Abrufen der Liste der Laufwerk-Ressourcen für einen Ziel-Benutzer oder eine Ziel-Gruppe. Ihre App kann auch den Satz von Dokumentbibliotheken auf der SharePoint-Stammwebsite anfordern.

Voraussetzungen

Einer der folgenden Bereiche ist erforderlich, um diese API auszuführen:

  • Files.Read
  • Files.ReadWrite
  • Files.Read.All
  • Files.ReadWrite.All
  • Sites.Read.All
  • Sites.ReadWrite.All

HTTP-Anforderung

GET /drives
GET /me/drives
GET /sites/{site-id}/drives

Optionale Abfrageparameter

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und eine Sammlung von Drive-Objekten im Antworttext zurückgegeben.

Beispiel

Anforderung

Hier ist ein Beispiel für die Anforderung der Laufwerke des Benutzers.

GET https://graph.microsoft.com/v1.0/me/drives
Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 579

{
  "value": [
    {
      "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
      }
    }
  ]
}

Bemerkungen

Die meisten Benutzer verfügen nur über eine einzige Laufwerkressource. Gruppen und einige Benutzer verfügen möglicherweise über mehrere Laufwerke.