ディレクトリ ロールのメンバーを削除する

名前空間: microsoft.graph

directoryRole からメンバーを削除します。

この API では、 directoryRole のオブジェクト ID とテンプレート ID の両方を使用できます。 組み込みロールのテンプレート ID は不変であり、Microsoft Entra 管理センターのロールの説明で確認できます。 詳細については、「 ロール テンプレート ID」を参照してください。

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

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

アクセス許可

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

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

HTTP 要求

ディレクトリ ロールは、 その ID または roleTemplateId を使用してアドレス指定できます。

DELETE /directoryRoles/{role-id}/members/{id}/$ref
DELETE /directoryRoles(roleTemplateId='{roleTemplateId}')/members/{id}/$ref

注意

が要求に追加されず、呼び出し元のアプリにメンバー オブジェクトを管理するためのアクセス許可がある場合/$ref、オブジェクトもMicrosoft Entra IDから削除されます。それ以外の場合はエラー403 Forbiddenが返されます。 削除されたアイテムの復元 API を使用して、特定のオブジェクトを復元できます。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。 応答本文では何も返されません。

例 1: ロール ID を使用してディレクトリ ロール メンバーを削除する

要求

この例では、 をディレクトリ ロールの id 値にbb165b45-151c-4cf6-9911-cd7188912848置き換え、ディレクトリ ロールから割り当てを解除するユーザーまたはディレクトリ オブジェクトの id 値に置き換えますf8e85ed8-f66f-4058-b170-3efae8b9c6e5

DELETE https://graph.microsoft.com/v1.0/directoryRoles/f8e85ed8-f66f-4058-b170-3efae8b9c6e5/members/bb165b45-151c-4cf6-9911-cd7188912848/$ref

応答

HTTP/1.1 204 No Content

例 2: roleTemplateId を使用してディレクトリ ロール メンバーを削除する

要求

次の例は要求を示しています。 を roleTemplateId の値に置き換え、bb165b45-151c-4cf6-9911-cd7188912848ディレクトリ オブジェクトのユーザーの id 値に置き換えます9f06204d-73c1-4d4c-880a-6edb90606fd8

DELETE https://graph.microsoft.com/v1.0/directoryRoles(roleTemplateId='9f06204d-73c1-4d4c-880a-6edb90606fd8')/members/bb165b45-151c-4cf6-9911-cd7188912848/$ref

応答

HTTP/1.1 204 No Content