Ressourcentyp „driveItem“

Namespace: microsoft.graph

Stellt Dateien, Ordner oder andere Elemente dar, die auf einem Laufwerk gespeichert sind.

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 Facetten, die als Eigenschaften modelliert sind und Daten über die Identitäten und Fähigkeiten des DriveItems bereitstellen. Zum Beispiel:

• Ordner haben eine Ordnerfacette
• Files haben eine Dateifacette.
• 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 eine Ordnerfacette aufweist.

Methoden

Eigenschaften

Hinweis: Die Eigenschaften eTag und cTag funktionieren bei Containern (Ordnern) unterschiedlich. Der cTag-Wert wird geändert, wenn der Inhalt oder die Metadaten eines nachgeordneten Elements 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 Nachkommen abgeleitet werden (z. B. childCount oder lastModifiedDateTime).

Beziehungen

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.

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 wird anschließend für kurze Zeit (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 veranschaulicht 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" },
  "lockInfo": { "@odata.type": "microsoft.graph.lockInfo" },
  "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" },
  "viewpoint": { "@odata.type": "microsoft.graph.driveItemViewpoint" },
  "webDavUrl": "string",

  /* relationships */
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "children": [{ "@odata.type": "microsoft.graph.driveItem" }],
  "createdByUser": { "@odata.type": "microsoft.graph.user" },
  "retentionLabel": { "@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"
}