Endgültiges Löschen eines Elements (Verzeichnisobjekt)
Namespace: microsoft.graph
Löschen Sie endgültig ein zuletzt gelöschtes Anwendungs-, Gruppen-, ServicePrincipal- oder Benutzerobjekt aus gelöschten Elementen. Nachdem ein Element endgültig gelöscht wurde, kann es nicht wiederhergestellt werden.
Verwaltungseinheiten können nicht mit der deletedItems-API endgültig gelöscht werden. Vorläufig gelöschte Verwaltungseinheiten werden 30 Tage nach dem ersten Löschen endgültig gelöscht, es sei denn, sie werden wiederhergestellt.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
In der folgenden Tabelle sind die Berechtigungen mit den geringsten Berechtigungen aufgeführt, die zum Aufrufen dieser API für jeden unterstützten Ressourcentyp erforderlich sind. Befolgen Sie bewährte Methoden , um Berechtigungen mit den geringsten Berechtigungen anzufordern. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Unterstützte Ressource | Delegiert (Geschäfts-, Schul- oder Unikonto) | Delegiert (persönliches Microsoft-Konto) | Anwendung |
---|---|---|---|
application | Application.ReadWrite.All | Nicht unterstützt | Application.ReadWrite.OwnedBy |
group | Group.ReadWrite.All | Nicht unterstützt | Nicht unterstützt |
servicePrincipal | Application.ReadWrite.All | Nicht unterstützt | Application.ReadWrite.OwnedBy |
user | User.ReadWrite.All | Nicht unterstützt | Nicht unterstützt |
Wichtig
In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit einer unterstützten Rollenberechtigung zugewiesen werden. Die folgenden Rollen mit den geringsten Berechtigungen werden für diesen Vorgang unterstützt.
- So löschen Sie gelöschte Anwendungen oder Dienstprinzipale endgültig: Anwendungsadministrator, Cloudanwendungsadministrator oder Hybrididentitätsadministrator.
- So löschen Sie gelöschte Benutzer endgültig: Benutzeradministrator.
- So löschen Sie gelöschte Gruppen endgültig: Gruppen Administrator.
HTTP-Anforderung
DELETE /directory/deletedItems/{id}
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über 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
Anforderung
DELETE https://graph.microsoft.com/v1.0/directory/deletedItems/{object-id}
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 204 No Content