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 $expand
OData-Abfrageparameter , $select
$skipToken
, , $top
und $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.