Drive-Ressourcentyp
Die drive-Ressource ist das Objekt der obersten Ebene innerhalb des OneDrive eines Benutzers oder einer Dokumentbibliothek in SharePoint.
OneDrive-Benutzern steht immer mindestens ein Laufwerk zur Verfügung, das Standardlaufwerk. Benutzern ohne OneDrive-Lizenz steht möglicherweise kein Standardlaufwerk zur Verfügung.
JSON-Darstellung
Es folgt eine JSON-Darstellung einer Laufwerksressource.
Die drive-Ressource wird von baseItem abgeleitet und erbt Eigenschaften von dieser Ressource.
{
"activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
"id": "string",
"createdBy": { "@odata.type": "microsoft.graph.identitySet" },
"createdDateTime": "string (timestamp)",
"description": "string",
"driveType": "personal | business | documentLibrary",
"items": [ { "@odata.type": "microsoft.graph.driveItem" } ],
"lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
"lastModifiedDateTime": "string (timestamp)",
"name": "string",
"owner": { "@odata.type": "microsoft.graph.identitySet" },
"quota": { "@odata.type": "microsoft.graph.quota" },
"root": { "@odata.type": "microsoft.graph.driveItem" },
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
"special": [ { "@odata.type": "microsoft.graph.driveItem" }],
"system": { "@odata.type": "microsoft.graph.systemFacet" },
"webUrl": "url"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| createdBy | identitySet | Die Identität des Benutzers, des Geräts oder der Anwendung, von denen das Element erstellt wurde. Schreibgeschützt. |
| createdDateTime | dateTimeOffset | Datum und Uhrzeit der Elementerstellung. Schreibgeschützt. |
| description | Zeichenfolge | Stellt eine für den Benutzer sichtbare Beschreibung des Laufwerks bereit. Lese-/Schreibzugriff. |
| driveType | String | Beschreibt den Typ des Laufwerks, der durch diese Ressource dargestellt wird. Persönliche OneDrive-Laufwerke geben personal zurück. OneDrive for Business gibt business zurück. SharePoint-Dokumentbibliotheken geben documentLibrary zurück. Schreibgeschützt. |
| id | String | Der eindeutige Bezeichner des Laufwerks. Schreibgeschützt. |
| lastModifiedBy | identitySet | Die Identität des Benutzers, des Geräts und der Anwendung, von denen das Element zuletzt geändert wurde. Schreibgeschützt. |
| lastModifiedDateTime | dateTimeOffset | Datum und Uhrzeit der letzten Änderung des Elements. Schreibgeschützt. |
| name | string | Der Name des Elements. Lese-/Schreibzugriff. |
| owner | identitySet | Optional. Das Benutzerkonto, das das Laufwerk besitzt. Schreibgeschützt. |
| quota | quota | Optional. Informationen zum Speicherkontingent des Laufwerks. Schreibgeschützt. |
| sharepointIds | sharepointIds | Gibt Bezeichner zurück, die für SharePoint REST-Kompatibilität nützlich sind. Schreibgeschützt. |
| System | systemFacet | Falls vorhanden, gibt an, dass es sich um ein vom System verwaltetes Laufwerk handelt. Schreibgeschützt. |
| webUrl | String (URL) | URL, über die die Ressource im Browser angezeigt werden kann. Schreibgeschützt. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| Aktivitäten | itemActivity-Sammlung | Die Liste der letzten Aktivitäten, die für dieses Laufwerk durchgeführt wurden. |
| items | DriveItem-Sammlung | Alle im Laufwerk enthaltenen Elemente. Schreibgeschützt. Lässt Nullwerte zu. |
| root | DriveItem | Der Stammordner des Laufwerks. Schreibgeschützt. |
| Sonderfall | DriveItem-Sammlung | Sammlung gemeinsamer Ordner, die in OneDrive zur Verfügung stehen. Schreibgeschützt. Nullwerte zulassend. |
| Liste | List | Für Laufwerke in SharePoint die zugrunde liegende Dokumentbibliothek-Liste. Schreibgeschützt. Nullwerte zulassend. |
Methoden
| Häufige Aufgaben | HTTP-Methode |
|---|---|
| Abrufen der Laufwerks-Metadaten eines anderen Laufwerks | GET /drives/{drive-id} |
| Abrufen des Stammordners des Standardlaufwerks des Benutzers | GET /drive/root |
| Auflisten der Aktivitäten unter dem Laufwerk | GET /drive/activities |
| Auflisten der untergeordneten Elemente des Laufwerks | GET /drive/root/children |
| Auflisten der Änderungen für alle Elemente auf dem Laufwerk | GET /drive/root/delta |
| Suchen nach Elementen auf dem Laufwerk | GET /drive/root/search |
| Abrufen spezieller Ordner | GET /drive/special/{name} |
In der vorstehenden Tabelle verwenden die Beispiele /drive, andere Pfade sind jedoch ebenfalls gültig.