driveItem: permanentDelete
Namespace: microsoft.graph
Löschen Sie ein driveItem-Objekt dauerhaft mithilfe seiner ID. Wenn Sie Elemente mit dieser Methode löschen, werden sie dauerhaft entfernt und nicht in den Papierkorb gesendet, im Gegensatz zur delete driveItem-API , die das Element an den Papierkorb sendet. Aus diesem Grund können dauerhaft gelöschte Laufwerkselemente später nicht wiederhergestellt werden.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Files.ReadWrite | Files.ReadWrite.All, Sites.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Files.ReadWrite | Files.ReadWrite.All |
Anwendung | Files.ReadWrite.All | Sites.ReadWrite.All |
HTTP-Anforderung
POST /drives/{drive-id}/items/{item-id}/permanentDelete
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Annehmen | application/json |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content
zurückgegeben. Es gibt nichts im Antworttext zurück.
Beispiel
Das folgende Beispiel illustriert, wie Sie diese API aufrufen können.
Anforderung
POST https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/permanentDelete
Antwort
HTTP/1.1 204 No Content
Fehlerantworten
Ausführliche Informationen zur Rückgabe von Fehlern finden Sie unter Fehlerantworten.