Freigeben über


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/v1.0/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.