Verfügbare Laufwerke auflistenList available drives

Namespace: microsoft.graphNamespace: microsoft.graph

Rufen Sie die Liste der Laufwerk-Ressourcen ab, die für einen Ziel-Benutzer, eine Ziel-Gruppe oder eine Ziel-Seite verfügbar sind.Retrieve the list of Drive resources available for a target User, Group, or Site.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
AnwendungApplication Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Auflisten des Laufwerks einer GruppeList a group's drives

Für die Auflistung der Dokumentbibliotheken einer Gruppe fordert Ihre App die drives-Beziehung bei der Gruppe an.To list the document libraries for a group, your app requests the drives relationship on the Group.

HTTP-AnforderungHTTP request

GET /groups/{groupId}/drives

Auflisten der Laufwerke einer WebsiteList a site's drives

Für die Auflistung der Dokumentbibliotheken einer Website fordert Ihre App die drives-Beziehung bei der Website an.To list the document libraries for a site, your app requests the drives relationship on the Site.

GET /sites/{siteId}/drives

Die Laufwerke eines Benutzers auflistenList a user's drives

GET /users/{userId}/drives

Die Laufwerke des aktuellen Benutzers auflistenList the current user's drives

GET /me/drives

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt die $expand, $select, $skipToken, $top und $orderby OData-Abfrageparameter zur Anpassung der Antwort.This method supports the $expand, $select, $skipToken, $top, and $orderby OData query parameters to customize the response.

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und eine Sammlung von Drive-Objekten im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and collection of Drive objects in the response body.

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

HinweiseRemarks

Die meisten Benutzer verfügen nur über eine einzige Laufwerkressource.Most users will only have a single Drive resource.

Gruppen und Webseiten verfügen möglicherweise über mehrere Laufwerksressourcen.Groups and Sites may have multiple Drive resources available.

Laufwerke mit dem System-Facet sind standardmäßig ausgeblendet.Drives with the system facet are hidden by default. Fügen Sie system in Ihre $select-Anweisung ein, um sie aufzulisten.To list them, include system in your $select statement.