domain: forceDelete

名前空間: microsoft.graph

非同期の実行時間の長い操作を使用してドメインを削除します。

この操作を実行する前に、プロビジョニング サービスとして Exchange への参照を更新または削除する必要があります。

この操作の一部として、次のアクションが実行されます。

  • usersuserPrincipalNamemail、およびproxyAddressesプロパティを、削除されたドメインへの参照で更新して、初期 onmicrosoft.com ドメインを使用します。

  • 最初の onmicrosoft.com ドメインを使用するように、削除されたドメインへの参照を使用して、groupsmail プロパティを更新します。

  • 最初の onmicrosoft.com ドメインを使用するように、削除されたドメインへの参照を使用して、applicationsidentifierUris プロパティを更新します。

  • 名前を変更するオブジェクトの数が 1000 を超える場合は、エラーが返されます。

  • 名前を変更する applications のいずれかがマルチテナント アプリの場合は、エラーが返されます。

ドメインの削除が完了すると、削除されたドメインの API 操作によって HTTP 404 状態コードが返されます。 ドメインの削除を確認するには、 ドメインの取得 操作を実行します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) Domain.ReadWrite.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Domain.ReadWrite.All 注意事項なし。

職場または学校アカウントは、少なくとも ドメイン名管理者Microsoft Entra ロールに属している必要があります。

HTTP 要求

POST /domains/{id}/forceDelete

{Id} には、ドメインを完全修飾ドメイン名で指定します。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json

要求本文

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。

パラメーター 種類 説明
disableUserAccounts Boolean 名前が変更されたユーザー アカウントを無効にするオプション。 ユーザー アカウントが無効になっている場合、ユーザーはサインインできません。 を true に設定すると、この操作の一部として更新されたユーザーは無効になります。 既定値は、true です。

応答本文

成功した場合、このメソッドは状態コード HTTP/1.1 204 OK 返します。

要求

POST https://graph.microsoft.com/v1.0/domains/{id}/forceDelete
Content-type: application/json

{
  "disableUserAccounts": true
}

応答

HTTP/1.1 204 OK