检查成员组

检查特定组列表中的成员资格,并从该列表返回成员为指定的 user、group 或 directory 对象的组。此函数是可传递的。

权限

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) User.Read.All 和 Group.Read.All、Directory.Read.All
委派(个人 Microsoft 帐户) 不支持。
应用程序 User.Read.All 和 Group.Read.All、Directory.Read.All

HTTP 请求

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

请求标头

名称 类型 说明
Authorization string Bearer {token}。必需。
Content-Type application/json  

请求正文

在请求正文中,提供具有以下参数的 JSON 对象。

参数 类型 说明
groupIds String 包含检查成员身份的组中的对象 ID 的集合。可以指定多达 20 个组。

响应

如果成功,此方法在响应正文中返回 200 OK 响应代码和 String 集合对象。

示例

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

{
  "groupIds": [
        "fee2c45b-915a-4a64-b130-f4eb9e75525e",
        "4fe90ae7-065a-478b-9400-e0a0e1cbd540"
  ]
}
响应

注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

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

{
  "value": [
        "fee2c45b-915a-4a64-b130-f4eb9e75525e"
  ]
}