Drive-Ressourcentypdrive resource type

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported. Um zu ermitteln, ob eine API in v 1.0 verfügbar ist, verwenden Sie die Versions Auswahl.To determine whether an API is available in v1.0, use the Version selector.

Die drive-Ressource ist das Objekt der obersten Ebene innerhalb des OneDrive eines Benutzers oder einer Dokumentbibliothek in SharePoint.The drive resource is the top level object representing a user's OneDrive or a document library in SharePoint.

OneDrive-Benutzern steht immer mindestens ein Laufwerk zur Verfügung, das Standardlaufwerk. Benutzern ohne OneDrive-Lizenz steht möglicherweise kein Standardlaufwerk zur Verfügung.OneDrive users will always have at least one drive available, their default drive. Users without a OneDrive license may not have a default drive available.

MethodenMethods

MethodeMethod RückgabetypReturn type BeschreibungDescription
Get drive (Laufwerk abrufen)Get drive drivedrive Abrufen von Metadaten zu einem LaufwerkGet metadata about a drive
Get drive root (Laufwerkstamm abrufen)Get drive root driveItemdriveItem Abrufen des Stammordners eines LaufwerksGet root folder of a drive
List activities (Aktivitäten auflisten)List activities itemActivity-SammlungitemActivity collection Auflisten von Aktivitäten, die unter dem Laufwerk stattgefunden habenList activities that occurred under the drive
List followed items (Elemente, denen gefolgt wird, auflisten)List followed items driveItem-SammlungdriveItem collection Auflisten der driveItem-Elemente, denen der Benutzer folgtList the user's followed driveItems
List children (Untergeordnete Elemente auflisten)List children driveItem-SammlungdriveItem collection Auflisten der untergeordneten Elemente im Stammordner eines LaufwerksList children of the root folder of a drive
List changes (Änderungen auflisten)List changes driveItem-SammlungdriveItem collection Auflisten der Änderungen für alle driveItem-Elemente auf dem LaufwerkList changes for all driveItems in the Drive
Search (Suchen)Search driveItem-SammlungdriveItem collection Suchen nach driveItem-Elementen in einem LaufwerkSearch for driveItems in a drive
Get special folder (Speziellen Ordner abrufen)Get special folder driveItemdriveItem Zugreifen auf einen speziellen Ordner anhand des kanonischen NamensAccess a special folder by its canonical name

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
createdBycreatedBy identitySetidentitySet Die Identität des Benutzers, des Geräts oder der Anwendung, von denen das Element erstellt wurde. Schreibgeschützt.Identity of the user, device, or application which created the item. Read-only.
createdDateTimecreatedDateTime dateTimeOffsetdateTimeOffset Datum und Uhrzeit der Elementerstellung. Schreibgeschützt.Date and time of item creation. Read-only.
descriptiondescription ZeichenfolgeString Stellt eine für den Benutzer sichtbare Beschreibung des Laufwerks bereit.Provide a user-visible description of the drive. Lese-/Schreibzugriff.Read-write.
driveTypedriveType StringString Beschreibt den Typ des Laufwerks, der durch diese Ressource dargestellt wird. Persönliche OneDrive-Laufwerke geben personal zurück. OneDrive for Business gibt business zurück. SharePoint-Dokumentbibliotheken geben documentLibrary zurück. Schreibgeschützt.Describes the type of drive represented by this resource. OneDrive personal drives will return personal. OneDrive for Business will return business. SharePoint document libraries will return documentLibrary. Read-only.
idid StringString Der eindeutige Bezeichner des Laufwerks. Schreibgeschützt.The unique identifier of the drive. 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.
namename stringstring Der Name des Elements. Lese-/Schreibzugriff.The name of the item. Read-write.
ownerowner identitySetidentitySet Optional. Das Benutzerkonto, das das Laufwerk besitzt. Schreibgeschützt.Optional. The user account that owns the drive. Read-only.
quotaquota quotaquota Optional. Informationen zum Speicherkontingent des Laufwerks. Schreibgeschützt.Optional. Information about the drive's storage space quota. 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.
Systemsystem systemFacetsystemFacet Falls vorhanden, gibt an, dass es sich um ein vom System verwaltetes Laufwerk handelt.If present, indicates that this is a system-managed drive. Schreibgeschützt.Read-only.
webUrlwebUrl String (URL)string (url) URL, über die die Ressource im Browser angezeigt werden kann. Schreibgeschützt.URL that displays the resource in the browser. Read-only.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
Aktivitätenactivities itemActivity-SammlungitemActivity collection Die Liste der letzten Aktivitäten, die für dieses Laufwerk durchgeführt wurden.The list of recent activities that took place under this drive.
bundlesbundles driveItem-SammlungdriveItem collection Sammlung von Paketen (Alben und multi-select-shared-Elementsätze).Collection of bundles (albums and multi-select-shared sets of items). Nur im persönlichen OneDrive.Only in personal OneDrive.
followingfollowing driveItem-SammlungdriveItem collection Die Liste von Elementen, denen der Benutzer folgt.The list of items the user is following. Nur in OneDrive for Business.Only in OneDrive for Business.
itemsitems driveItem-SammlungdriveItem collection Alle im Laufwerk enthaltenen Elemente. Schreibgeschützt. Lässt Nullwerte zu.All items contained in the drive. Read-only. Nullable.
rootroot driveItemdriveItem Der Stammordner des Laufwerks. Schreibgeschützt.The root folder of the drive. Read-only.
Sonderfallspecial driveItem-SammlungdriveItem collection Sammlung gemeinsamer Ordner, die in OneDrive zur Verfügung stehen. Schreibgeschützt. Lässt Nullwerte zu.Collection of common folders available in OneDrive. Read-only. Nullable.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung einer Laufwerksressource.Here is a JSON representation of a Drive resource.

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

{
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "id": "string",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "string (timestamp)",
  "description": "string",
  "driveType": "personal | business | documentLibrary",
  "following": [{"@odata.type": "microsoft.graph.driveItem"}],
  "items": [{"@odata.type": "microsoft.graph.driveItem"}],
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "string (timestamp)",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.identitySet"},
  "quota": {"@odata.type": "microsoft.graph.quota"},
  "root": {"@odata.type": "microsoft.graph.driveItem"},
  "special": [{"@odata.type": "microsoft.graph.driveItem"}],
  "system": {"@odata.type": "microsoft.graph.systemFacet"},
  "webUrl": "string",
  "sharepointIds": {"@odata.type": "microsoft.graph.sharepointIds"}
}