Löschen eines BenutzersDelete a user

• 12.03.2021
• 2 Minuten Lesedauer
• • j
  • o

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.

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

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}

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

await graphClient.Users["{user-id}"]
    .Request()
    .DeleteAsync();

const options = {
    authProvider,
};

const client = Client.init(options);

await client.api('/users/{user-id}')
    .delete();

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/users/{user-id}"]]];
[urlRequest setHTTPMethod:@"DELETE"];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

graphClient.users("{user-id}")
    .buildRequest()
    .delete();

AntwortResponse

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

HTTP/1.1 204 No Content