Ressourcentyp „driveItem“
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Stellt eine Datei, einen Ordner oder ein anderes Element dar, das auf einem Laufwerk gespeichert ist.
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
Weitere Informationen finden Sie unter Adressierung von driveItems.
DriveItem-Ressourcen verfügen über Facets, die als Eigenschaften modelliert sind, die Daten zu den Identitäten und Funktionen von driveItem bereitstellen. Zum Beispiel:
- Ordner haben ein Ordnerfacet
- Dateien haben ein Dateifacet.
- 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 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 cTag-Eigenschaft nicht zurückgegeben, wenn das driveItem-Element über ein Ordnerfacet verfügt.
Methoden
| Methode | REST-Pfad |
|---|---|
| Get item | GET /drive/items/{item-id} |
| Aktivitäten auflisten | GET /drive/items/{item-id}/activities |
| Analysen abrufen | GET /drive/items/{item-id}/analytics |
| Aktivitäten nach Intervall abrufen | GET /drive/items/{item-id}/getActivitiesByInterval |
| Untergeordnete Elemente auflisten | GET /drive/items/{item-id}/children |
| Versionen auflisten | GET /drive/items/{item-id}/versions |
| Element erstellen | POST /drive/items/{item-id}/children |
| Update item | PATCH /drive/items/{item-id} |
| Upload content | PUT /drive/items/{item-id}/content |
| Inhalt herunterladen (veraltet) | GET /drive/items/{item-id}/content |
| Inhalte herunterladen | GET /drive/items/{item-id}/contentStream |
| Herunterladen eines bestimmten Dateiformats | GET /drive/items/{item-id}/content?format={format} |
| Element löschen | DELETE /drive/items/{item-id} |
| PermanentLöschen des Elements | POST /drives/{driveId}/items/{itemId}/permanentDelete |
| Element wiederherstellen | POST /drive/items/{item-id}/restore |
| 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') |
| List changes in a drive | GET /drive/root/delta |
| Element folgen | POST /drives/{drive-id}/items/{item-id}/follow |
| Element nicht folgen | POST /drives/{drive-id}/items/{item-id}/unfollow |
| 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 |
| Berechtigung löschen | DELETE /drive/items/{item-id}/permissions/{perm-id} |
| WebSocket-Kanal erhalten | GET /drive/root/subscriptions/socketIo |
| Element in Vorschau anzeigen | POST /drive/items/{item-id}/preview |
| Einchecken | POST /drives/{driveId}/items/{itemId}/checkin |
| Auschecken | POST /drives/{driveId}/items/{itemId}/checkout |
| Zuweisungen widerrufen | PATCH /drive/items/{item-id}/permissions/{perm-id}/revokeGrants |
| Extrahieren von Vertraulichkeitsbezeichnungen | POST /drive/items/{item-id}/extractSensitivityLabels |
| Vertraulichkeitsbezeichnung zuweisen | POST /drive/items/{item-id}/assignSensitivityLabel |
| Abrufen der Aufbewahrungsbezeichnung | GET /drives/{drive-id}/items/{id}/retentionLabel |
| Festlegen der Aufbewahrungsbezeichnung | PATCH /drives/{drive-id}/items/{id}/retentionLabel |
| Entfernen der Aufbewahrungsbezeichnung | DELETE /drives/{drive-id}/items/{id}/retentionLabel |
| Sperren oder Entsperren des Datensatzes | PATCH /drives/{drive-id}/items/{id}/retentionLabel |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| audio | audio | Audiometadaten, wenn das Element eine Audiodatei ist. Schreibgeschützt. Nur auf OneDrive Personal. |
| bundle | Bündel | Bündelmetadaten, wenn das Element ein Bündel ist. Schreibgeschützt. |
| Inhalt (veraltet) | Stream | Der Inhaltsdatenstrom, wenn das Element eine Datei ist Die Inhaltseigenschaft wird in Zukunft möglicherweise eine breaking Änderung des Verhaltens aufweisen. Inhalte werden direkt gestreamt, anstatt umzuleiten. Um das neue Verhalten proaktiv zu aktivieren, verwenden Sie stattdessen die contentStream-Eigenschaft . |
| contentStream | Stream | Der Inhaltsdatenstrom, wenn das Element eine Datei ist |
| createdBy | identitySet | Identität des Benutzers, geräts und der Anwendung, die das Element erstellt haben. 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 | 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 | Identität des Benutzers, geräts und der Anwendung, die das Element zuletzt geändert hat. 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. |
| media | media | Informationen zum Medienelement (Audio oder Video). Lese-/Schreibzugriff. Nur auf OneDrive for Business und SharePoint. |
| 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 | Falls vorhanden, gibt an, dass mindestens ein Vorgang, der sich auf den Zustand des driveItem auswirken kann, aussteht. Schreibgeschützt. |
| photo | 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 stellt Informationen zum freigegebenen Zustand des Elements bereit. 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. |
| source | driveItemSource | Informationen zur Laufwerkelementquelle. Schreibgeschützt. Nur auf OneDrive for Business und SharePoint. |
| 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 funktionieren in Containern (Ordnern) unterschiedlich. Der cTag-Wert wird geändert, wenn Inhalt oder Metadaten eines Nachfolgers des Ordners geändert werden. Der eTag-Wert wird nur geändert, wenn die Eigenschaften des Ordners geändert werden, mit Ausnahme von Eigenschaften, die von Nachfolgern abgeleitet sind (z. B. 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. Lässt Nullwerte zu. |
| 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. Lässt Nullwerte zu. |
| Berechtigungen | permission collection | Der Satz von Berechtigungen für das Element. Schreibgeschützt. Nullwerte zulassend. |
| retentionLabel | itemRetentionLabel | Informationen zur Aufbewahrungsbezeichnung und einstellungen, die für das driveItem erzwungen werden. Lese-/Schreibzugriff. |
| Abonnements | Abonnement-Sammlung | Die Gruppe von Abonnements für das Element. Wird nur im Stammordner eines Laufwerks unterstützt. |
| thumbnails | thumbnailSet collection | Auflistung von thumbnailSet-Objekten , die dem Element zugeordnet sind. Weitere Informationen finden Sie unter 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 | Für Dateien, bei denen es sich um Excel-Kalkulationstabellen handelt, greifen Sie auf die Arbeitsmappen-API zu, um mit dem Inhalt der Kalkulationstabelle zu arbeiten. Nullwerte zulassend. |
Instanzenattribute
Instanzattribute sind Eigenschaften mit besonderem Verhalten. Diese Eigenschaften sind temporär und definieren entweder das Verhalten, das der Dienst ausführen soll, oder stellen kurzfristige Eigenschaftswerte bereit, z. B. eine Download-URL für ein element, das abläuft.
| 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. Für diese URL ist keine Authentifizierung erforderlich. Schreibgeschützt. |
| @microsoft.graph.sourceUrl | string | Diese instance Anmerkung kann verwendet werden, um den Dienst anzuweisen, den Inhalt der URL beim Ausgeben einer PUT-Anforderung herunterzuladen und als Datei zu speichern. Schreibzugriff. |
Hinweis: Der Parameter
@microsoft.graph.conflictBehaviorsollte in der URL und nicht im Textkörper der Anfrage enthalten sein.Der Wert
@microsoft.graph.downloadUrlist eine kurzlebige URL und kann nicht zwischengespeichert werden. Die URL wird nach für einen kurzen Zeitraum (1 Stunde) ungültig. 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
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
Die driveItem-Ressource wird von baseItem abgeleitet und erbt Eigenschaften von dieser Ressource.
{
"audio": { "@odata.type": "microsoft.graph.audio" },
"bundle": { "@odata.type": "microsoft.graph.bundle" },
"content": { "@odata.type": "Edm.Stream" },
"contentStream": { "@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" },
"media": { "@odata.type": "microsoft.graph.media" },
"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,
"source": { "@odata.type": "microsoft.graph.driveItemSource" },
"specialFolder": { "@odata.type": "microsoft.graph.specialFolder" },
"video": { "@odata.type": "microsoft.graph.video" },
"webDavUrl": "string",
/* relationships */
"activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
"children": [{ "@odata.type": "microsoft.graph.driveItem" }],
"createdByUser": { "@odata.type": "microsoft.graph.user" },
"itemRetentionLabel": [{ "@odata.type": "microsoft.graph.itemRetentionLabel" }],
"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"
}
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für