Ressourcentyp „DriveItem“

Eine DriveItem-Ressource repräsentiert ein Element in einem Laufwerk. Alle Dateisystemobjekte der obersten Ebene in OneDrive werden als Elementressourcen zurückgegeben.

Zugreifen können Sie auf DriveItems über ihre id mithilfe der Syntax /items/{item-id} oder über ihren Dateisystempfad mithilfe der Syntax /drive/root:/path/to/file.

Elemente verfügen über als Eigenschaften modellierte Facets, die Daten zu den Identitäten und Funktionen der Elemente bereitstellen. Ordner haben ein „folder“-Facet, Dateien ein „file“-Facet. Bilder haben zusätzlich zu ihrem „file“-Facet ein „image“-Facet. Mit einer Kamera aufgenommene Bilder (Fotos) haben ein „photo“-Facet, das die Elemente als Foto identifiziert und als Eigenschaften das Aufnahmedatum sowie das zur Aufnahme verwendete Gerät aufführt.

Elemente mit dem Facet folder fungieren als Elementcontainer und besitzen daher einen children-Verweis auf eine Elementsammlung in dem jeweiligen Ordner.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "audio": {"@odata.type": "microsoft.graph.audio"},
  "cTag": "string",
  "content": "stream",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "deleted": {"@odata.type": "microsoft.graph.deleted"},
  "eTag": "string",
  "file": {"@odata.type": "microsoft.graph.file"},
  "fileSystemInfo": {"@odata.type": "microsoft.graph.fileSystemInfo"},
  "folder": {"@odata.type": "microsoft.graph.folder"},
  "id": "string (identifier)",
  "image": {"@odata.type": "microsoft.graph.image"},
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "location": {"@odata.type": "microsoft.graph.geoCoordinates"},
  "name": "string",
  "package": {"@odata.type": "microsoft.graph.package"},
  "parentReference": {"@odata.type": "microsoft.graph.itemReference"},
  "photo": {"@odata.type": "microsoft.graph.photo"},
  "remoteItem": {"@odata.type": "microsoft.graph.remoteItem"},
  "searchResult": {"@odata.type": "microsoft.graph.searchResult"},
  "shared": {"@odata.type": "microsoft.graph.shared"},
  "size": 1024,
  "specialFolder": {"@odata.type": "microsoft.graph.specialFolder"},
  "video": {"@odata.type": "microsoft.graph.video"},
  "webDavUrl": "string",
  "webUrl": "string",

  "createdByUser": { "@odata.type": "microsoft.graph.user" },
  "lastModifiedByUser": { "@odata.type": "microsoft.graph.user" },
  "children": [ { "@odata.type": "microsoft.graph.driveItem" }],
  "thumbnails": [ {"@odata.type": "microsoft.graph.thumbnailSet"}],
  "permissions": [ {"@odata.type": "microsoft.graph.permission"} ]
}

Eigenschaften

Eigenschaft Typ Beschreibung
audio audio Audiometadaten, wenn das Element eine Audiodatei ist. Schreibgeschützt.
content Stream Der Inhaltsdatenstrom, wenn das Element eine Datei ist
createdBy identitySet Die Identität des Benutzers, des Geräts und der Anwendung, von denen das Element erstellt wurde. Schreibgeschützt.
createdDateTime DateTimeOffset Datum und Uhrzeit der Elementerstellung. Schreibgeschützt.
cTag String Ein ETag für den Inhalt des Elements. Dieses ETag wird nicht geändert, wenn nur die Metadaten geändert werden. Hinweis: Diese Eigenschaft wird nicht zurückgegeben, wenn das Element ein Ordner ist. Schreibgeschützt.
gelöscht deleted Informationen zum „gelöscht“-Zustand des Elements. Schreibgeschützt.
eTag String ETag des gesamten Elements (Metadaten + Inhalt). Schreibgeschützt.
file file Dateimetadaten, wenn das Element eine Datei ist. Schreibgeschützt.
fileSystemInfo fileSystemInfo Informationen zum Dateisystem des Clients. Lese-/Schreibzugriff.
folder folder Ordnermetadaten, wenn das Element ein Ordner ist. Schreibgeschützt.
id String Der eindeutige Bezeichner des Elements im Laufwerk. Schreibgeschützt.
Abbildung image Bildmetadaten, wenn das Element ein Bild ist. 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.
location geoCoordinates Standortmetadaten, sofern das Element Standortdaten aufweist. Schreibgeschützt.
name String Der Name des Elements (Dateiname und Erweiterung). Lese-/Schreibzugriff.
package package Zeigt wenn vorhanden an, dass das Element ein Paket ist statt eines Ordners oder einer Datei. Pakete werden in einigen Kontexten wie Dateien, in anderen Kontexten wie Ordner behandelt. Schreibgeschützt.
parentReference itemReference Informationen zum übergeordneten Element, wenn das Element ein übergeordnetes Element hat. Lese-/Schreibzugriff.
Foto photo Fotometadaten, wenn das Element ein Foto ist. Schreibgeschützt.
remoteItem remoteItem Daten zum Remoteelement, wenn das Element von einem anderen Laufwerk freigegeben ist als dem, auf das zugegriffen wird. Schreibgeschützt.
searchResult searchResult Suchmetadaten, wenn das Element aus einem Suchergebnis stammt. Schreibgeschützt.
freigegeben shared Gibt an, dass das Element für andere freigegeben wurde, und enthält den „freigegeben“-Status des Elements. Schreibgeschützt.
size Int64 Größe des Elements in Byte. Schreibgeschützt.
specialFolder specialFolder Facet, das zurückgegeben wird, wenn das aktuelle Element auch als spezieller Ordner verfügbar ist. Schreibgeschützt.
video video Videometadaten, wenn das Element ein Video ist. Schreibgeschützt.
webUrl String URL, über die die Ressource im Browser angezeigt werden kann. Schreibgeschützt.

Hinweis: Die Eigenschaften „eTag“ und „cTag“ arbeiten bei Containern (Ordnern) anders. Der Wert „cTag“ wird geändert, wenn Inhalte oder Metadaten eines Nachfolgers des Ordners geändert werden. Der Wert „eTag“ wird nur geändert, wenn die Eigenschaften des Ordners geändert werden. Ausnahme: Eigenschaften, die von Nachfolgern abgeleitet werden (wie childCount oder lastModifiedDateTime).

Instanzenattribute

Instanzenattribute sind Eigenschaften mit speziellem Verhalten. Diese Eigenschaften sind temporär. Sie definieren entweder, wie sich der Dienst verhalten soll, oder geben kurzfristige Eigenschaftswerte an, beispielsweise URLs zum Elementdownload, die ablaufen.

Eigenschaftenname Typ Beschreibung
@microsoft.graph.conflictBehavior string Das Konfliktlösungsverhalten von Aktionen, die ein neues Element erstellen. Verwenden Sie die Werte fail, replace oder rename. Das Standardformat für PUT ist replace. Ein Element wird nie mit dieser Anmerkung zurückgegeben. Schreibzugriff.
@microsoft.graph.downloadUrl string Eine URL, über die die Inhalte der Datei heruntergeladen werden können. Eine Authentifizierung ist mit dieser URL nicht erforderlich. Schreibgeschützt.
@microsoft.graph.sourceUrl string Bei Ausgabe einer PUT-Anforderung kann der Dienst mithilfe dieser Instanzanmerkung angewiesen werden, den Inhalt der URL herunterzuladen und als diese Datei zu speichern. Schreibzugriff.

Hinweis: Der Wert „@microsoft.graph.downloadUrl“ ist eine kurzlebige URL und kann nicht zwischengespeichert werden. Die URL ist nur für kurze Zeit verfügbar, bevor sie ungültig wird.

Beziehungen

Beziehung Typ Beschreibung
children driveitem collection Sammlung von Elementobjekten der direkten untergeordneten Elemente eines Elements. Nur Elemente, die Ordner repräsentieren, haben untergeordnete Elemente. Schreibgeschützt. Lässt Nullwerte zu.
createdByUser Benutzer Die Identität des Benutzers, des Geräts und der Anwendung, von denen das Element erstellt wurde. Schreibgeschützt.
lastModifiedByUser Benutzer Die Identität des Benutzers, des Geräts und der Anwendung, von denen das Element zuletzt geändert wurde. Schreibgeschützt.
Berechtigungen permission collection Der Satz von Berechtigungen für das Element. Schreibgeschützt. Lässt Nullwerte zu.
thumbnails thumbnailSet collection Sammlung der dem Element zugeordneten ThumbnailSet-Objekte. Weitere Informationen finden Sie im Artikel zum Abrufen von Miniaturansichten. Schreibgeschützt. Lässt Nullwerte zu.

Methods

Method REST-Pfad
Get item GET /drive/items/{item-id}
List children GET /drive/items/{item-id}/children
Create item POST /drive/items/{item-id}/children
Update item PATCH /drive/items/{item-id}
Upload content PUT /drive/items/{item-id}/content
Download content GET /drive/items/{item-id}/content
Delete item DELETE /drive/items/{item-id}
Move item PATCH /drive/items/{item-id}
Copy item POST /drive/items/{item-id}/copy
Search items GET /drive/items/{item-id}/search(q='text')
Find changes GET /drive/root/delta
List thumbnails GET /drive/items/{item-id}/thumbnails
Create sharing link POST /drive/items/{item-id}/createLink
Add permissions POST /drive/items/{item-id}/invite
List permissions GET /drive/items/{item-id}/permissions
Delete permission DELETE /drive/items/{item-id}/permissions/{perm-id}

Bemerkungen

In OneDrive for Business- oder SharePoint-Dokumentbibliotheken wird die Eigenschaft cTag nicht zurückgegeben, wenn das Element ein Ordner ist.