DriveItem-RessourcentypDriveItem resource type

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.The driveItem resource represents a file, folder, or other item stored in a drive. All file system objects in OneDrive and SharePoint are returned as driveItem resources.

Es gibt zwei Hauptmethoden zum Adressieren einer driveItem-Ressource:There are two primary ways of addressing a driveItem resource:

  • Durch den eindeutigen driveItem-Bezeichner unter Verwendung von drive/items/{item-id}By the driveItem unique identifier using drive/items/{item-id}
  • Durch den Dateisystempfad unter Verwendung von /drive/root:/path/to/fileBy file system path using /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:DriveItem resources have facets modeled as properties that provide data about the driveItem's identities and capabilities. For example:

  • Ordner haben ein [„folder“-Facet][-Ordner]Folders have a folder facet
  • Dateien haben eine [„file“-Facet][-Datei].Files have a file facet.
  • Bilder haben zusätzlich zu ihrem „file“-Facet ein [„image“Facet][-Bild].Images have an image facet in addition to their file facet.
  • 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.Images taken with a camera (photos) have a photo facet that identifies the item as a photo and provides the properties of when the photo was taken and with what device.

Elemente mit dem folder-Facet fungieren als Elementcontainer und besitzen daher einen children-Verweis auf eine Sammlung von driveItems im jeweiligen Ordner.Items with the folder facet act as containers of items and therefore have a children reference pointing to a collection of driveItems under the folder.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung einer driveItem-Ressource.Here is a JSON representation of a driveItem resource.

Die driveItem-Ressource wird von baseItem abgeleitet und erbt Eigenschaften von dieser Ressource.The driveItem resource is derived from baseItem and inherits properties from that resource.

{
  "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" },
  "package": { "@odata.type": "microsoft.graph.package" },
  "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 */
  "children": [{ "@odata.type": "microsoft.graph.driveItem" }],
  "createdByUser": { "@odata.type": "microsoft.graph.user" },
  "lastModifiedByUser": { "@odata.type": "microsoft.graph.user" },
  "permissions": [ {"@odata.type": "microsoft.graph.permission"} ],
  "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"
}

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
audioaudio audioaudio Audiometadaten, wenn das Element eine Audiodatei ist. Schreibgeschützt.Audio metadata, if the item is an audio file. Read-only.
contentcontent StreamStream Der Inhaltsdatenstrom, wenn das Element eine Datei istThe content stream, if the item represents a file.
createdBycreatedBy identitySetidentitySet Die Identität des Benutzers, des Geräts und der Anwendung, von denen das Element erstellt wurde. Schreibgeschützt.Identity of the user, device, and application which created the item. Read-only.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Datum und Uhrzeit der Elementerstellung. Schreibgeschützt.Date and time of item creation. Read-only.
cTagcTag StringString 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.An eTag for the content of the item. This eTag is not changed if only the metadata is changed. Note This property is not returned if the item is a folder. Read-only.
gelöschtdeleted deleteddeleted Informationen zum „gelöscht“-Zustand des Elements. Schreibgeschützt.Information about the deleted state of the item. Read-only.
descriptiondescription ZeichenfolgeString Stellt eine für den Benutzer sichtbare Beschreibung des Elements bereit. Lese-/Schreibzugriff. Nur auf OneDrive PersonalProvides a user-visible description of the item. Read-write. Only on OneDrive Personal
eTageTag StringString ETag des gesamten Elements (Metadaten + Inhalt). Schreibgeschützt.eTag for the entire item (metadata + content). Read-only.
filefile filefile Dateimetadaten, wenn das Element eine Datei ist. Schreibgeschützt.File metadata, if the item is a file. Read-only.
fileSystemInfofileSystemInfo fileSystemInfofileSystemInfo Informationen zum Dateisystem des Clients. Lese-/Schreibzugriff.File system information on client. Read-write.
folderfolder [Ordner][]folder Ordnermetadaten, wenn das Element ein Ordner ist. Schreibgeschützt.Folder metadata, if the item is a folder. Read-only.
idid StringString Der eindeutige Bezeichner des Elements im Laufwerk. Schreibgeschützt.The unique identifier of the item within the Drive. Read-only.
Abbildungimage imageimage Bildmetadaten, wenn das Element ein Bild ist. Schreibgeschützt.Image metadata, if the item is an image. Read-only.
lastModifiedBylastModifiedBy identitySetidentitySet Die Identität des Benutzers, des Geräts und der Anwendung, von denen das Element zuletzt geändert wurde. Schreibgeschützt.Identity of the user, device, and application which last modified the item. Read-only.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Datum und Uhrzeit der letzten Änderung des Elements. Schreibgeschützt.Date and time the item was last modified. Read-only.
locationlocation geoCoordinatesgeoCoordinates Standortmetadaten, sofern das Element Standortdaten aufweist. Schreibgeschützt.Location metadata, if the item has location data. Read-only.
namename StringString Der Name des Elements (Dateiname und Erweiterung). Lese-/Schreibzugriff.The name of the item (filename and extension). Read-write.
packagepackage packagepackage 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.If present, indicates that this item is a package instead of a folder or file. Packages are treated like files in some contexts and folders in others. Read-only.
parentReferenceparentReference itemReferenceitemReference Informationen zum übergeordneten Element, wenn das Element ein übergeordnetes Element hat. Lese-/Schreibzugriff.Parent information, if the item has a parent. Read-write.
Fotophoto photophoto Fotometadaten, wenn das Element ein Foto ist. Schreibgeschützt.Photo metadata, if the item is a photo. Read-only.
Veröffentlichungpublication publicationFacetpublicationFacet Stellt Informationen über den veröffentlichten oder ausgecheckten Status eines Elements an Stellen bereit, die solche Aktionen unterstützen.Provides information about the published or checked-out state of an item, in locations that support such actions. Diese Eigenschaft wird standardmäßig nicht zurückgegeben.This property is not returned by default. Schreibgeschützt.Read-only.
remoteItemremoteItem remoteItemremoteItem Daten zum Remoteelement, wenn das Element von einem anderen Laufwerk freigegeben ist als dem, auf das zugegriffen wird. Schreibgeschützt.Remote item data, if the item is shared from a drive other than the one being accessed. Read-only.
rootroot rootroot Wenn diese Eigenschaft nicht Null ist, bedeutet dies, dass es sich bei der driveItem-Ressource um die oberste driveItem-Ressource auf dem Laufwerk handelt.If this property is non-null, it indicates that the driveItem is the top-most driveItem in the drive.
searchResultsearchResult searchResultsearchResult Suchmetadaten, wenn das Element aus einem Suchergebnis stammt. Schreibgeschützt.Search metadata, if the item is from a search result. Read-only.
freigegebenshared sharedshared Gibt an, dass das Element für andere freigegeben wurde, und enthält den „freigegeben“-Status des Elements. Schreibgeschützt.Indicates that the item has been shared with others and provides information about the shared state of the item. Read-only.
sharepointIdssharepointIds sharepointIdssharepointIds Gibt Bezeichner zurück, die für SharePoint REST-Kompatibilität nützlich sind. Schreibgeschützt.Returns identifiers useful for SharePoint REST compatibility. Read-only.
sizesize Int64Int64 Größe des Elements in Byte. Schreibgeschützt.Size of the item in bytes. Read-only.
specialFolderspecialFolder specialFolderspecialFolder Facet, das zurückgegeben wird, wenn das aktuelle Element auch als spezieller Ordner verfügbar ist. Schreibgeschützt.If the current item is also available as a special folder, this facet is returned. Read-only.
videovideo videovideo Videometadaten, wenn das Element ein Video ist. Schreibgeschützt.Video metadata, if the item is a video. Read-only.
webDavUrlwebDavUrl StringString WebDAV-kompatible URL für das Element.WebDAV compatible URL for the item.
webUrlwebUrl StringString URL, über die die Ressource im Browser angezeigt werden kann. Schreibgeschützt.URL that displays the resource in the browser. Read-only.

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).Note: The eTag and cTag properties work differently on containers (folders). The cTag value is modified when content or metadata of any descendant of the folder is changed. The eTag value is only modified when the folder's properties are changed, except for properties that are derived from descendants (like childCount or lastModifiedDateTime).

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
childrenchildren driveitem-Sammlungdriveitem collection Sammlung von Elementobjekten der direkten untergeordneten Elemente eines Elements. Nur Elemente, die Ordner repräsentieren, haben untergeordnete Elemente. Schreibgeschützt. Nullwerte zulassend.Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
createdByUsercreatedByUser useruser Der Name des Benutzers, der das Element erstellt hat.Identity of the user who created the item. Schreibgeschützt.Read-only.
lastModifiedByUserlastModifiedByUser useruser Der Name des Benutzers, der das Element zuletzt geändert hat.Identity of the user who last modified the item. Schreibgeschützt.Read-only.
listItemlistItem listItemlistItem Für Laufwerke in SharePoint das zugehörige Dokumentbibliothek-Listenelement.For drives in SharePoint, the associated document library list item. Schreibgeschützt.Read-only. Lässt Nullwerte zu.Nullable.
Berechtigungenpermissions permission collectionpermission collection Der Satz von Berechtigungen für das Element. Schreibgeschützt. Lässt Nullwerte zu.The set of permissions for the item. Read-only. Nullable.
thumbnailsthumbnails thumbnailSet collectionthumbnailSet collection Sammlung der dem Element zugeordneten ThumbnailSet-Objekte. Weitere Informationen finden Sie im Artikel zum Abrufen von Miniaturansichten. Schreibgeschützt. Nullwerte zulassend.Collection containing ThumbnailSet objects associated with the item. For more info, see getting thumbnails. Read-only. Nullable.
versionsversions driveItemVersion-SammlungdriveItemVersion collection Die Liste der früheren Versionen des Elements.The list of previous versions of the item. Weitere Informationen finden Sie unter Abrufen früherer Versionen.For more info, see getting previous versions. Schreibgeschützt.Read-only. Nullwerte zulassend.Nullable.
workbookworkbook workbookworkbook Greift für Dateien, die Excel-Tabellen sind, auf die Workbook-API zu, um mit dem Inhalt der Tabelle zu arbeiten.For files that are Excel spreadsheets, accesses the workbook API to work with the spreadsheet's contents. Nullwerte zulassend.Nullable.

InstanzenattributeInstance Attributes

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.Instance attributes are properties with special behaviors. These properties are temporary and either a) define behavior the service should perform or b) provide short-term property values, like a download URL for an item that expires.

EigenschaftennameProperty name TypType BeschreibungDescription
@microsoft.graph.conflictBehavior@microsoft.graph.conflictBehavior stringstring 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.The conflict resolution behavior for actions that create a new item. You can use the values fail, replace, or rename. The default for PUT is replace. An item will never be returned with this annotation. Write-only.
@microsoft.graph.downloadUrl@microsoft.graph.downloadUrl stringstring Eine URL, über die die Inhalte der Datei heruntergeladen werden können. Eine Authentifizierung ist mit dieser URL nicht erforderlich. Schreibgeschützt.A URL that can be used to download this file's content. Authentication is not required with this URL. Read-only.
@microsoft.graph.sourceUrl@microsoft.graph.sourceUrl stringstring 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.When issuing a PUT request, this instance annotation can be used to instruct the service to download the contents of the URL, and store it as the file. Write-only.

Hinweis: 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.Note: The @microsoft.graph.downloadUrl value is a short-lived URL and can't be cached. The URL will only be available for a short period of time (1 hour) before it is invalidated.

MethodenMethods

MethodMethod REST-PfadREST Path
Get itemGet item GET /drive/items/{item-id}
Untergeordnete Elemente auflistenList children GET /drive/items/{item-id}/children
Versionen auflistenList versions GET /drive/items/{item-id}/versions
Element erstellenCreate item POST /drive/items/{item-id}/children
Update itemUpdate item PATCH /drive/items/{item-id}
Upload contentUpload content PUT /drive/items/{item-id}/content
Inhalte herunterladenDownload content GET /drive/items/{item-id}/content
Bestimmtes Dateiformat herunterladenDownload specific file format GET /drive/items/{item-id}/content?format={format}
Element löschenDelete item DELETE /drive/items/{item-id}
Move itemMove item PATCH /drive/items/{item-id}
Copy itemCopy item POST /drive/items/{item-id}/copy
Search itemsSearch items GET /drive/items/{item-id}/search(q='text')
List changes in a driveList changes in a drive GET /drive/root/delta
List thumbnailsList thumbnails GET /drive/items/{item-id}/thumbnails
Create sharing linkCreate sharing link POST /drive/items/{item-id}/createLink
Add permissionsAdd permissions POST /drive/items/{item-id}/invite
List permissionsList permissions GET /drive/items/{item-id}/permissions
Berechtigung löschenDelete permission DELETE /drive/items/{item-id}/permissions/{perm-id}
Element in Vorschau anzeigenPreview item POST /drive/items/{item-id}/preview

HinweiseRemarks

In OneDrive for Business- oder SharePoint-Dokumentbibliotheken wird die Eigenschaft cTag nicht zurückgegeben, wenn die driveItem-Ressource ein [Ordner][]-Facet hat.In OneDrive for Business or SharePoint document libraries, the cTag property is not returned, if the driveItem has a folder facet.