Drive-Ressourcentypdrive resource type

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.

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.

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"}
}

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.
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.
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.

MethodenMethods

Häufige AufgabenCommon task HTTP-MethodeHTTP method
Abrufen der Laufwerks-Metadaten eines anderen LaufwerksGet Drive metadata of another Drive GET /drives/{drive-id}
Abrufen des Stammordners des Standardlaufwerks des BenutzersGet root folder for user's default Drive GET /drive/root
Auflisten der Aktivitäten unter dem LaufwerkList activities under the Drive GET /drive/activities
Auflisten der Elemente, denen gefolgt wirdList followed Items GET /drive/following
Auflisten der untergeordneten Elemente des LaufwerksList children under the Drive GET /drive/root/children
Auflisten der Änderungen für alle Elemente auf dem LaufwerkList changes for all Items in the Drive GET /drive/root/delta
Suchen nach Elementen auf dem LaufwerkSearch for Items in the Drive GET /drive/root/search
Abrufen spezieller OrdnerAccess special folder GET /drive/special/{name}

In der vorstehenden Tabelle verwenden die Beispiele /drive, andere Pfade sind jedoch ebenfalls gültig.In the previous table, the examples use /drive, but other paths are valid too.