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-Benutzern steht immer mindestens ein Laufwerk zur Verfügung, das Standardlaufwerk. Benutzern ohne OneDrive-Lizenz steht möglicherweise kein Standardlaufwerk zur Verfügung.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Get drive (Laufwerk abrufen) | drive | Abrufen von Metadaten zu einem Laufwerk |
| Get drive root (Laufwerkstamm abrufen) | driveItem | Abrufen des Stammordners eines Laufwerks |
| List activities (Aktivitäten auflisten) | itemActivity-Sammlung | Auflisten von Aktivitäten, die unter dem Laufwerk stattgefunden haben |
| List followed items (Elemente, denen gefolgt wird, auflisten) | driveItem-Sammlung | Auflisten der driveItem-Elemente, denen der Benutzer folgt |
| List children (Untergeordnete Elemente auflisten) | driveItem-Sammlung | Auflisten der untergeordneten Elemente im Stammordner eines Laufwerks |
| List changes (Änderungen auflisten) | driveItem-Sammlung | Auflisten der Änderungen für alle driveItem-Elemente auf dem Laufwerk |
| Search (Suchen) | driveItem-Sammlung | Suchen nach driveItem-Elementen in einem Laufwerk |
| Get special folder (Speziellen Ordner abrufen) | driveItem | Zugreifen auf einen speziellen Ordner anhand des kanonischen Namens |
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 | Falls vorhanden, gibt an, dass es sich um ein vom System verwaltetes Laufwerk handelt. 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",
}