Ressourcentyp drive

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 drive-Ressource.

Die drive-Ressource wird von baseItem abgeleitet und erbt Eigenschaften von dieser Ressource.

{
  "id": "string (identifier)",
  "driveType": "string",
  "owner": {"@odata.type": "microsoft.graph.identitySet"},
  "quota": {"@odata.type": "microsoft.graph.quota"},
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },

  /* relationships */
  "root": {"@odata.type": "microsoft.graph.driveItem" },
  "items": [ {"@odata.type": "microsoft.graph.driveItem" }],
  "special": [ {"@odata.type": "microsoft.graph.driveItem" }],

  /* inherited from baseItem */
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "createdDateTime": "datetime",
  "description": "string",
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "datetime",
  "name": "string",
  "webUrl": "url"
}

Eigenschaften

Eigenschaft Typ Beschreibung
id String Der eindeutige Bezeichner des Laufwerks. Schreibgeschützt.
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.
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.
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.
webUrl string (URL) URL, über die die Ressource im Browser angezeigt werden kann. Schreibgeschützt.

Beziehungen

Beziehung Typ Beschreibung
items driveitem collection Alle im Laufwerk enthaltenen Elemente. Schreibgeschützt. Lässt Nullwerte zu.
root driveitem Der Stammordner des Laufwerks. Schreibgeschützt.
Sonderfall driveitem collection Sammlung gemeinsamer Ordner, die in OneDrive zur Verfügung stehen. Schreibgeschützt. Lässt Nullwerte zu.

Methoden

Die folgenden Methoden stehen für Laufwerksressourcen zur Verfügung.

Methode REST-Pfad
Abrufen des Standardlaufwerks des Benutzers GET /me/drive
Abrufen des Laufwerks eines anderen Benutzers GET /users/{user-id}/drive
Abrufen des Stammordners für ein Laufwerk GET /drives/{drive-id}/root
Auflisten von Elementen auf einem Laufwerk GET /me/drive/root/children
Auflisten von Änderungen auf einem Laufwerk GET /me/drive/root/delta
Suchen nach Elementen auf einem Laufwerk GET /me/drive/search(q='text')