メンバー グループを取得する

指定したユーザー、グループ、またはディレクトリ オブジェクトがメンバーであるすべてのグループを返します。この関数は、推移的です。

前提条件

この API を実行するには、以下のいずれかのスコープが必要です。 - User.Read.All および Group.Read.All - Directory.Read.All

注:アクセス許可のスコープは、必要な特権が最小限の順に一覧表示されます。

HTTP 要求

POST /me/getMemberGroups
POST /users/{id | userPrincipalName}/getMemberGroups
POST /groups/{id}/getMemberGroups
POST /directoryObjects/{id}/getMemberGroups

要求ヘッダー

名前 説明
Authorization string Bearer . Required.
Content-Type application/json  

要求本文

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

パラメーター 説明
securityEnabledOnly ブール型 エンティティがメンバーであるセキュリティ グループのみを返すように指定するには true、がメンバーであるすべてのグループとディレクトリ ロールを返すように指定するには false を設定します。:パラメーターが true の場合、関数はユーザーでのみ呼び出せます。

応答

成功した場合、このメソッドは 200, OK 応答コードと、応答本文で文字列コレクション オブジェクトを返します。

要求
POST https://graph.microsoft.com/v1.0/me/getMemberGroups
Content-type: application/json

{
  "securityEnabledOnly": true
}
応答

注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(Edm.String)",
    "value": [
        "fee2c45b-915a-4a64-b130-f4eb9e75525e",
        "4fe90ae7-065a-478b-9400-e0a0e1cbd540",
        "e0c3beaf-eeb4-43d8-abc5-94f037a65697"
    ]
}