Domäne: forceDeletedomain: forceDelete

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Löscht eine Domäne mithilfe eines asynchronen Vorgangs.Deletes a domain using an asynchronous operation.

Die folgenden Aktionen werden im Rahmen dieses Vorgangs ausgeführt:The following actions are performed as part of this operation:

  • Benennt den UPN, die e-maile-Datei und die proxyAddress von Benutzern mit Verweisen auf die gelöschte Domäne um.Renames the UPN, EmailAddress, and ProxyAddress of users with references to the deleted domain.

  • Benennt die e-maile-Email von Gruppen mit Verweisen auf die gelöschte Domäne um.Renames the EmailAddress of groups with references to the deleted domain.

  • Benennt die identifierUris von Anwendungen mit Verweisen auf die gelöschte Domäne um.Renames the identifierUris of applications with references to the deleted domain.

  • Wenn die Anzahl der umzubenennenden Objekte größer als 1000 ist, wird ein Fehler zurückgegeben.If the number of objects to be renamed is greater than 1000, an error is returned.

  • Wenn eine der umzubenennenden Anwendungen eine Multi-Mandanten-APP ist, wird ein Fehler zurückgegeben.If one of the applications to be renamed is a multi-tenant app, an error is returned.

Nach Abschluss der Domänen Löschung gibt API-Vorgänge für die gelöschte Domäne einen 404-HTTP-Antwortcode zurück.After the domain deletion completes, API operations for the deleted domain will return a 404 HTTP response code. Sie können eine Get-Domänedurchführen, um das Löschen einer Domäne zu überprüfen.To verify deletion of a domain, you can perform a get domain. Wenn die Domäne erfolgreich gelöscht wurde, wird in der Antwort ein 404-HTTP-Antwortcode zurückgegeben.If the domain was successfully deleted, a 404 HTTP response code will be returned in the response.

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 Domain.ReadWrite.AllDomain.ReadWrite.All

HTTP-AnforderungHTTP request

POST /domains/{id}/forceDelete

Geben Sie für {id} die Domäne mit ihrem vollqualifizierten Domänennamen an.For {id}, specify the domain with its fully qualified domain name.

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

AnforderungstextRequest body

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.In the request body, provide a JSON object with the following parameters.

ParameterParameter TypType BeschreibungDescription
disableUserAccountsdisableUserAccounts BooleschBoolean Option zum Deaktivieren umbenannter Benutzerkonten.Option to disable renamed user accounts. Wenn ein Benutzerkonto deaktiviert ist, darf sich der Benutzer nicht anmelden.If a user account is disabled, the user will not be allowed to sign in.
True (Standard) – Benutzerkonten, die im Rahmen dieses Vorgangs umbenannt wurden, sind deaktiviert.True (default) - User accounts renamed as part of this operation are disabled.
False -Benutzerkonten, die im Rahmen dieses Vorgangs umbenannt wurden, sind nicht deaktiviert.False - User accounts renamed as part of this operation are not disabled.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 200 OK zurückgegeben.If successful, this method returns 200 OK response code.

BeispielExample

AnforderungRequest
POST https://graph.microsoft.com/beta/domains/contoso.com/forceDelete
Content-type: application/json
Content-length: 33

{
  "disableUserAccounts": true
}
AntwortResponse
HTTP/1.1 200 OK