Ressourcentyp „driveItem“

Namespace: microsoft.graph

Die driveItem-Ressource stellt eine Datei, einen Ordner oder ein anderes auf einem Laufwerk gespeichertes Element dar.

Alle Dateisystemobjekte in OneDrive und SharePoint werden als driveItem-Ressourcen zurückgegeben. Elemente in SharePoint-Dokumentbibliotheken können als listItem- oder driveItem-Ressourcen dargestellt werden.

Es gibt zwei Hauptmethoden zum Adressieren einer driveItem-Ressource:

  • Durch den eindeutigen driveItem-Bezeichner unter Verwendung von drive/items/{item-id}
  • Durch den Dateisystempfad unter Verwendung von /drive/root:/path/to/file

driveItem-Ressourcen verfügen über als Eigenschaften modellierte Facets, die Daten zu den driveItem-Identitäten und -Funktionen bereitstellen. Beispiel:

  • Ordner haben ein [„folder“-Facet][-Ordner]
  • Dateien haben eine [„file“-Facet][-Datei].
  • Bilder haben zusätzlich zu ihrem „file“-Facet ein [„image“Facet][-Bild].
  • Mit einer Kamera aufgenommene Bilder (Fotos) haben ein [„photo“-Facet][-Foto], das die Elemente als Foto identifiziert und als Eigenschaften das Aufnahmedatum sowie das zur Aufnahme verwendete Gerät aufführt.

Elemente mit dem folder-Facet fungieren als Elementcontainer und besitzen daher einen children-Verweis auf eine Sammlung von driveItems im jeweiligen Ordner.

Hinweis: In OneDrive for Business- oder SharePoint-Dokumentbibliotheken wird die Eigenschaft cTag nicht zurückgegeben, wenn die driveItem-Ressource ein [Ordner][]-Facet hat.

Methoden

Methode Rückgabetyp Beschreibung
Get item driveItem Mit dieser API können Sie die Metadaten einer Ressource des Typs DriveItem in einer Ressource des Typs Drive abrufen.
Analysen abrufen itemAnalytics Abrufen von Analysen für diese Ressource.
Aktivitäten nach Intervall abrufen itemActivityStat Eine Sammlung von itemActivityStats innerhalb des angegebenen Zeitintervalls abrufen.
Untergeordnetes Element auflisten Sammlung von driveItem Eine Auflistung von DriveItems im untergeordneten Verhältnis eines DriveItem zurückgeben.
Versionen auflisten Sammlung von DriveItemVersion Die Versionen einer Datei werden auf dem Laufwerk des aktuellen Benutzers abgerufen.
Element erstellen driveItem Erstellt ein driveItem auf dem angegebenen Laufwerk.
Update item driveItem Aktualisiert ein driveItem in das Laufwerk.
Upload content driveItem Lädt Inhalte im driveItem hoch.
Inhalte herunterladen URL herunterladen Lädt Inhalte eines driveItem heruntergeladen.
Herunterladen eines bestimmten Dateiformats URL herunterladen Lädt Inhalte eines driveItem mit einem bestimmten Format herunter.
Element löschen Kein Inhalt Ein driveItem-Element löschen.
Move item driveItem Ein driveItem in einem übergeordneten Element verschieben.
Element kopieren detaillierte Informationen zum Überwachen des Status der Kopie Diese Methode erstellt eine Kopie einer Ressource des Typs „driveItem“ (einschließlich aller untergeordneten Elemente).
Elemente suchen Sammlung von driveItem Durchsuchen Sie die Hierarchie der Elemente nach Elementen, die mit einer Abfrage übereinstimmen.
Änderungen auf einem Laufwerk auflisten Delta-Link Alle Änderungen im Laufwerk auflisten.
Follow Item driveItem Einem DriveItem-Element folgen.
Unfollow Item Kein Inhalt Einem DriveItem-Element nicht mehr folgen.
List thumbnails Sammlung von driveItem DriveItems mit ihren Miniaturansichten auflisten.
Create sharing link Freigabelink Erstellen Sie einen Link zum Freigeben der driveItem.
Add permissions Sammlung von [Berechtigungen][] Sendet eine Einladung zur Freigabe an einen Benutzer.
Berechtigungen auflisten Sammlung von [Berechtigungen][] Ruft die Sammlung von Berechtigungen für ein driveItem ab.
Berechtigung löschen Kein Inhalt Entfernt die Berechtigungs des driveItem.
WebSocket-Kanal erhalten subscription Empfängt nahezu in Echtzeit Änderungsbenachrichtigungen für ein Laufwerk mit socket.io.
Element in Vorschau anzeigen JSON-Objekt Erhalten Sie kurzzeitig einbindbare URLs für ein Element, um eine temporäre Vorschau zu erstellen.
Einchecken POST /drives/{driveId}/items/{itemId}/checkin
Auschecken POST /drives/{driveId}/items/{itemId}/checkout

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.
description Zeichenfolge Stellt eine für den Benutzer sichtbare Beschreibung des Elements bereit. Lese-/Schreibzugriff. Nur auf OneDrive Personal
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 [Ordner][] 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.
Schadsoftware Schadsoftware Schadsoftware-Metadaten, wenn entdeckt wurde, dass das Element Schadsoftware enthält. 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.
pendingOperations pendingOperations Gibt, falls vorhanden, an, dass mindestens ein Vorgang, der sich auf den Status von driveItem auswirken kann, noch aussteht. Schreibgeschützt.
Foto photo Fotometadaten, wenn das Element ein Foto ist. Schreibgeschützt.
Veröffentlichung publicationFacet Stellt Informationen über den veröffentlichten oder ausgecheckten Status eines Elements an Stellen bereit, die solche Aktionen unterstützen. Diese Eigenschaft wird standardmäßig nicht zurückgegeben. Schreibgeschützt.
remoteItem remoteItem Daten zum Remoteelement, wenn das Element von einem anderen Laufwerk freigegeben ist als dem, auf das zugegriffen wird. Schreibgeschützt.
root root Wenn diese Eigenschaft nicht Null ist, bedeutet dies, dass es sich bei der driveItem-Ressource um die oberste driveItem-Ressource auf dem Laufwerk handelt.
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.
sharepointIds sharepointIds Gibt Bezeichner zurück, die für SharePoint REST-Kompatibilität nützlich sind. 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.
webDavUrl String WebDAV-kompatible URL für das Element.
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).

Beziehungen

Beziehung Typ Beschreibung
Aktivitäten ItemActivity-Sammlung Die Liste der letzten Aktivitäten, die für dieses Element durchgeführt wurden.
Analysen itemAnalytics-Ressource Analysen zu den Anzeigeaktivitäten, die auf diesem Element stattgefunden haben.
Untergeordnetes Element driveitem-Sammlung Sammlung von Elementobjekten der direkten untergeordneten Elemente eines Elements. Nur Elemente, die Ordner repräsentieren, haben untergeordnete Elemente. Schreibgeschützt. Nullwerte zulassend.
createdByUser user Der Name des Benutzers, der das Element erstellt hat. Schreibgeschützt.
lastModifiedByUser user Der Name des Benutzers, der das Element zuletzt geändert hat. Schreibgeschützt.
listItem listItem Für Laufwerke in SharePoint das zugehörige Dokumentbibliothek-Listenelement. Schreibgeschützt. Nullwerte zulassend.
Berechtigungen permission collection Der Satz von Berechtigungen für das Element. Schreibgeschützt. Lässt Nullwerte zu.
Abonnements Abonnement-Sammlung Die Gruppe von Abonnements für das Element. Wird nur im Stammordner eines Laufwerks unterstützt.
thumbnails thumbnailSet collection Sammlung der dem Element zugeordneten ThumbnailSet-Objekte. Weitere Informationen finden Sie im Artikel zum Abrufen von Miniaturansichten. Schreibgeschützt. Nullwerte zulassend.
versions driveItemVersion-Sammlung Die Liste der früheren Versionen des Elements. Weitere Informationen finden Sie unter Abrufen früherer Versionen. Schreibgeschützt. Nullwerte zulassend.
workbook workbook Greift für Dateien, die Excel-Tabellen sind, auf die Workbook-API zu, um mit dem Inhalt der Tabelle zu arbeiten. Nullwerte zulassend.

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 Parameter @microsoft.graph.conflictBehavior sollte in der URL und nicht im Textkörper der Anfrage enthalten sein.

Der Wert @microsoft.graph.downloadUrl ist eine kurzlebige URL und kann nicht zwischengespeichert werden. Die URL ist nur für kurze Zeit (1 Stunde) verfügbar, bevor sie ungültig wird. Beim Entfernen von Dateiberechtigungen für einen Benutzer wird die URL möglicherweise nicht sofort ungültig.

Die @microsoft.graph.sourceUrl-Eigenschaft für den Dateiupload wird in OneDrive for Business, SharePoint Online und SharePoint Server 2016 nicht unterstützt.

JSON-Darstellung

Es folgt eine JSON-Darstellung einer driveItem-Ressource.

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

{
  "audio": { "@odata.type": "microsoft.graph.audio" },
  "content": { "@odata.type": "Edm.Stream" },
  "cTag": "string (etag)",
  "deleted": { "@odata.type": "microsoft.graph.deleted"},
  "description": "string",
  "file": { "@odata.type": "microsoft.graph.file" },
  "fileSystemInfo": { "@odata.type": "microsoft.graph.fileSystemInfo" },
  "folder": { "@odata.type": "microsoft.graph.folder" },
  "image": { "@odata.type": "microsoft.graph.image" },
  "location": { "@odata.type": "microsoft.graph.geoCoordinates" },
  "malware": { "@odata.type": "microsoft.graph.malware" },
  "package": { "@odata.type": "microsoft.graph.package" },
  "pendingOperations": { "@odata.type": "microsoft.graph.pendingOperations" },
  "photo": { "@odata.type": "microsoft.graph.photo" },
  "publication": {"@odata.type": "microsoft.graph.publicationFacet"},
  "remoteItem": { "@odata.type": "microsoft.graph.remoteItem" },
  "root": { "@odata.type": "microsoft.graph.root" },
  "searchResult": { "@odata.type": "microsoft.graph.searchResult" },
  "shared": { "@odata.type": "microsoft.graph.shared" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "size": 1024,
  "specialFolder": { "@odata.type": "microsoft.graph.specialFolder" },
  "video": { "@odata.type": "microsoft.graph.video" },
  "webDavUrl": "string",

  /* relationships */
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "analytics": {"@odata.type": "microsoft.graph.itemAnalytics"},
  "children": [{ "@odata.type": "microsoft.graph.driveItem" }],
  "createdByUser": { "@odata.type": "microsoft.graph.user" },
  "lastModifiedByUser": { "@odata.type": "microsoft.graph.user" },
  "permissions": [ {"@odata.type": "microsoft.graph.permission"} ],
  "subscriptions": [ {"@odata.type": "microsoft.graph.subscription"} ],
  "thumbnails": [ {"@odata.type": "microsoft.graph.thumbnailSet"}],
  "versions": [ {"@odata.type": "microsoft.graph.driveItemVersion"}],

  /* inherited from baseItem */
  "id": "string (identifier)",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "eTag": "string",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "name": "string",
  "parentReference": {"@odata.type": "microsoft.graph.itemReference"},
  "webUrl": "string",

  /* instance annotations */
  "@microsoft.graph.conflictBehavior": "string",
  "@microsoft.graph.downloadUrl": "url",
  "@microsoft.graph.sourceUrl": "url"
}