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.