Löschen eines BenutzersDelete a user

Namespace: microsoft.graphNamespace: microsoft.graph

Dient zum Löschen eines Benutzers.Delete user.

Beim Löschen werden Benutzerressourcen in einen temporären Container verschoben und können innerhalb von 30 Tagen wiederhergestellt werden.When deleted, user resources are moved to a temporary container and can be restored within 30 days. Nach diesem Zeitraum werden sie endgültig gelöscht.After that time, they are permanently deleted. Weitere Informationen finden Sie unter deletedItems.To learn more, see deletedItems.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Directory.AccessAsUser.AllDirectory.AccessAsUser.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication User.ReadWrite.AllUser.ReadWrite.All

Das Geschäfts-, Schul- oder Unikonto muss in einer der folgenden Rollen sein:The work or school account must be in one of the following roles:

  • Globaler AdministratorGlobal Administrator
  • BenutzeradministratorUser Administrator

Nur ein globaler Administrator kann einen Benutzer mit der Rolle „globaler Administrator“ oder einen beliebigen Benutzer im Mandanten löschen.Only a Global Administrator can delete a user in a Global Administrator role or any user in the tenant. Ein Benutzeradministrator kann nur Benutzer löschen, die keine Administratoren sind oder bestimmte eingeschränkte Rollen aufweisen.A User Administrator can only delete users who are non-administrators or in specific limited roles. Weitere Details finden Sie unter Administratorrollenberechtigungen in Azure AD.For more details, see Administrator role permissions in Azure AD.

HTTP-AnforderungHTTP request

DELETE /users/{id | userPrincipalName}

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben. Im Antworttext wird nichts zurückgegeben.If successful, this method returns 204 No Content response code. It does not return anything in the response body.

BeispielExample

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.

DELETE https://graph.microsoft.com/v1.0/users/{user-id}

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.Here is an example of the response.

HTTP/1.1 204 No Content