反馈 编辑

List group transitive memberOf

  • 项目

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

获取组所属的组和管理单元。 此操作是可传递的，还将包括此组是其嵌套成员的所有组。 与获取用户的Microsoft 365组不同，这会返回所有类型的组，而不仅仅是Microsoft 365组。

权限

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

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

当应用程序查询返回 directoryObject 类型集合的关系时，如果它没有读取某种派生类型（如设备）的权限，则会返回该类型的成员，但返回的信息有限。 使用这种行为，应用程序可请求所需的最低特权权限，而不依赖于 Directory.* 集权限。 有关详细信息，请参阅为不可访问的成员对象返回有限的信息。

HTTP 请求

GET /groups/{id}/transitiveMemberOf

可选的查询参数

此方法支持OData query parameters以帮助自定义响应，包括 $search、$count、 和 $filter OData 强制转换也已启用，例如，可以强制转换以仅获取组的可传递组成员。 $search可以用在 displayName 属性。 为该资源添加或更新项目时，将对它们进行专门索引，以便与 $count 和 $search 查询参数一起使用。 在添加或更新项目与在索引中可用之间可能会稍有延迟。

请求标头

名称 说明
Authorization Bearer {token}。必需。
ConsistencyLevel 最终。 使用 $search、$filter、$orderby 或 OData 强制转换查询参数时，此标头和 $count 是必需的。 它使用的索引可能与对象的最新更改不同步。

请求正文

请勿提供此方法的请求正文。

响应

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

示例

示例 1：获取组是其可传递成员的组和管理单元

请求

下面展示了示例请求。

GET https://graph.microsoft.com/beta/groups/{id}/transitiveMemberOf

响应

下面展示了示例响应。

注意： 为了提高可读性，可能缩短了此处显示的响应对象。

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

{
  "value": [
    {
      "id": "11111111-2222-3333-4444-555555555555",
      "mail": "group1@contoso.com",
      "mailEnabled": true,
      "mailNickname": "ContosoGroup1",
      "securityEnabled": true
    }
  ]
}

示例 2：仅获取所有可传递成员身份的计数

请求

下面展示了示例请求。

GET https://graph.microsoft.com/beta/groups/{id}/transitiveMemberOf/$count
ConsistencyLevel: eventual

响应

下面展示了示例响应。

HTTP/1.1 200 OK
Content-type: text/plain

294

示例 3：使用 OData 强制转换以仅获取组中可传递成员身份的计数

请求

下面展示了示例请求。

GET https://graph.microsoft.com/beta/groups/{id}/transitiveMemberOf/microsoft.graph.group/$count
ConsistencyLevel: eventual

响应

下面介绍响应示例。

HTTP/1.1 200 OK
Content-type: text/plain

294

示例 4：使用 OData 强制转换和$search以包含字母“tier”的显示名称（包括返回的对象计数）的组中获取成员身份

请求

下面展示了示例请求。

GET https://graph.microsoft.com/beta/groups/{id}/transitiveMemberOf/microsoft.graph.group?$count=true&$orderby=displayName&$search="displayName:tier"&$select=displayName,id
ConsistencyLevel: eventual

响应

下面展示了示例响应。

注意： 为了提高可读性，可能缩短了此处显示的响应对象。

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

{
  "@odata.context":"https://graph.microsoft.com/beta/$metadata#groups(displayName,id)",
  "@odata.count":7,
  "value":[
    {
      "displayName":"Contoso-tier Query Notification",
      "id":"11111111-2222-3333-4444-555555555555"
    }
  ]
}

示例 5：使用 OData 强制转换和$filter获取以“A”开头的显示名称的成员身份，包括返回的对象计数

请求

下面展示了示例请求。

GET https://graph.microsoft.com/beta/groups/{id}/transitiveMemberOf/microsoft.graph.group?$count=true&$orderby=displayName&$filter=startswith(displayName, 'a')
ConsistencyLevel: eventual

响应

下面展示了示例响应。

注意： 为了提高可读性，可能缩短了此处显示的响应对象。

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

{
  "@odata.context":"https://graph.microsoft.com/beta/$metadata#groups",
  "@odata.count":76,
  "value":[
    {
      "displayName":"AAD Contoso Users",
      "mail":"AADContoso_Users@contoso.com",
      "mailEnabled":true,
      "mailNickname":"AADContoso_Users",
      "securityEnabled":true
    }
  ]
}