Freigeben über


Verfügbare Laufwerke auflisten

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.

Rufen Sie die Liste der Laufwerkressourcen ab, die für einen Zielbenutzer, eine Gruppe oder eine Zielwebsite verfügbar sind.

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
Delegiert (persönliches Microsoft-Konto) Files.Read Files.Read.All, Files.ReadWrite, Files.ReadWrite.All
App Files.Read.All Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-Anforderung

Auflisten der Laufwerke einer Gruppe

Für die Auflistung der Dokumentbibliotheken einer Gruppe fordert Ihre App die drives-Beziehung bei der Gruppe an.

GET /groups/{groupId}/drives

Auflisten der Laufwerke einer Website

Für die Auflistung der Dokumentbibliotheken einer Website fordert Ihre App die drives-Beziehung bei der Website an.

GET /sites/{siteId}/drives

Auflisten der Laufwerke eines Benutzers

GET /users/{userId}/drives

Auflisten der aktuellen Laufwerke eines Benutzers

GET /me/drives

Optionale Abfrageparameter

Diese Methode unterstützt die $expandOData-Abfrageparameter , $select$skipToken, , $topund $orderby zum Anpassen der Antwort.

Antwort

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

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET /me/drives

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "942CAEB0-13AE-491B-85E4-7557CDC0F25F",
      "driveType": "documentLibrary",
      "name": "Shared Documents",
      "owner": {
        "user": {
          "id": "AE2A1EE9-81A7-423C-ABE4-B945F47509BB",
          "displayName": "Ryan Gregg"
        }
      }
    },
    {
      "id": "C1CD3ED9-0E98-4B0B-82D3-C8FB784B9DCC",
      "driveType": "documentLibrary",
      "name": "Contoso Project Files",
      "owner": {
        "user": {
          "id": "406B2281-18E8-4416-9857-38C531B904F1",
          "displayName": "Daron Spektor"
        }
      }
    }
  ]
}

Hinweise

Die meisten Benutzer verfügen nur über eine einzelne Laufwerkressource.

Für Gruppen und Websites stehen möglicherweise mehrere Laufwerksressourcen zur Verfügung.

Laufwerke mit dem System-Facet sind standardmäßig ausgeblendet. Fügen Sie system in Ihre $select-Anweisung ein, um sie aufzulisten.