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