Drive-Ressourcentyp
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.
Die Laufwerksressource ist das Objekt der obersten Ebene, die das OneDrive oder eine Dokumentbibliothek eines Benutzers in Microsoft Office SharePoint Online darstellt.
OneDrive-Benutzer verfügen immer über mindestens ein Laufwerk, ihr Standardlaufwerk. Benutzern ohne OneDrive-Lizenz steht möglicherweise kein Standardlaufwerk zur Verfügung.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Laufwerk auflisten | drive-Sammlung | Rufen Sie die Liste der Laufwerkressourcen ab, die für einen Zielbenutzer, eine Gruppe oder eine Zielwebsite verfügbar sind. |
| Get drive (Laufwerk abrufen) | drive | Ruft Metadaten zu einem Laufwerk ab. |
| Get drive root (Laufwerkstamm abrufen) | driveItem | Ruft den Stammordner eines Laufwerks ab. |
| List activities (Aktivitäten auflisten) | itemActivity-Sammlung | Auflisten von Aktivitäten, die unter dem Laufwerk aufgetreten sind. |
| List followed items (Elemente, denen gefolgt wird, auflisten) | driveItem-Sammlung | Listet die vom Benutzer gefolgten driveItems auf. |
| List children (Untergeordnete Elemente auflisten) | driveItem-Sammlung | Listet die untergeordneten Elemente des Stammordners eines Laufwerks auf. |
| List changes (Änderungen auflisten) | driveItem-Sammlung | Auflisten der Änderungen für alle driveItems auf dem Laufwerk. |
| Search (Suchen) | driveItem-Sammlung | Suchen Sie in einem Laufwerk nach driveItems. |
| Get special folder (Speziellen Ordner abrufen) | driveItem | Greifen Sie über seinen kanonischen Namen auf einen speziellen Ordner zu. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| createdBy | identitySet | Identität des Benutzers, Geräts oder der Anwendung, die das Element erstellt hat. Schreibgeschützt. |
| createdDateTime | dateTimeOffset | Datum und Uhrzeit der Elementerstellung. Schreibgeschützt. |
| description | Zeichenfolge | Stellt eine für den Benutzer sichtbare Beschreibung des Laufwerks bereit. Lese-/Schreibzugriff. |
| driveType | String | Beschreibt den Typ des Laufwerks, der durch diese Ressource dargestellt wird. Persönliche OneDrive-Laufwerke geben zurück personal. OneDrive for Business gibt zurückbusiness. SharePoint-Dokumentbibliotheken geben zurück documentLibrary. Schreibgeschützt. |
| id | String | Der eindeutige Bezeichner des Laufwerks. Schreibgeschützt. |
| lastModifiedBy | identitySet | Identität des Benutzers, geräts und der Anwendung, die das Element zuletzt geändert haben. Schreibgeschützt. |
| lastModifiedDateTime | dateTimeOffset | Datum und Uhrzeit der letzten Änderung des Elements. Schreibgeschützt. |
| name | string | Der Name des Elements. Lese-/Schreibzugriff. |
| owner | identitySet | Optional. Das Benutzerkonto, das das Laufwerk besitzt. Schreibgeschützt. |
| quota | quota | Optional. Informationen zum Speicherkontingent des Laufwerks. Schreibgeschützt. |
| sharepointIds | sharepointIds | Gibt Bezeichner zurück, die für SharePoint REST-Kompatibilität nützlich sind. Schreibgeschützt. Diese Eigenschaft wird standardmäßig nicht zurückgegeben und muss mithilfe des $select Abfrageparameters ausgewählt werden. |
| System | systemFacet | Gibt an, dass es sich um ein vom System verwaltetes Laufwerk handelt, falls vorhanden. Schreibgeschützt. |
| webUrl | String (URL) | URL, über die die Ressource im Browser angezeigt werden kann. Schreibgeschützt. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| Aktivitäten | itemActivity-Sammlung | Die Liste der letzten Aktivitäten, die für dieses Laufwerk durchgeführt wurden. |
| bundles | driveItem-Sammlung | Sammlung von Paketen (Alben und multi-select-shared-Elementsätze). Nur im persönlichen OneDrive. |
| following | driveItem-Sammlung | Die Liste von Elementen, denen der Benutzer folgt. Nur in OneDrive for Business. |
| items | driveItem-Sammlung | Alle im Laufwerk enthaltenen Elemente. Schreibgeschützt. Lässt Nullwerte zu. |
| root | driveItem | Der Stammordner des Laufwerks. Schreibgeschützt. |
| Sonderfall | driveItem-Sammlung | Sammlung gemeinsamer Ordner, die in OneDrive zur Verfügung stehen. Schreibgeschützt. Nullwerte zulassend. |
| Liste | list | Für Laufwerke in SharePoint die zugrunde liegende Dokumentbibliothek-Liste. Schreibgeschützt. Nullwerte zulassend. |
JSON-Darstellung
Hier ist eine JSON-Darstellung einer Drive-Ressource.
Die drive-Ressource wird von baseItem abgeleitet und erbt Eigenschaften von dieser Ressource.
{
"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"},
"sharepointIds": {"@odata.type": "microsoft.graph.sharepointIds"},
"special": [{"@odata.type": "microsoft.graph.driveItem"}],
"system": {"@odata.type": "microsoft.graph.systemFacet"},
"webUrl": "string",
}