Azure Active Directory 组增量 API

Azure Active Directory Group Delta API

我正在为我的租户使用 Azure Active Directory 组 API 来列出所有组。我正在使用 GET DELTA

https://docs.microsoft.com/en-us/graph/api/group-delta?view=graph-rest-1.0&tabs=http

获取https://graph.microsoft.com/v1.0/groups/delta?$select=resourceBehaviorOptions,groupTypes,membershipRuleProcessingState,mail,visibility,displayName,mailEnabled,createdDateTime,creationOptions,proxyAddresses,securityIdentifier,resourceProvisioningOptions,id,securityEnabled,mailNickname,members

根据文档,我第一次调用时应该给我所有与组相关的元数据,最后它应该给我一个“delta-link”。这个 delta link 稍后调用时只会给出从那时起在组的元数据中所做的更改。

然而,在第一次调用期间,只有当我应该获取所有元数据时,我才获取带有注释@removed 的资源。根据我的理解,我应该只在调用 delta link 时获取更改,而不是第一次获取所有数据时

我想知道这是否是一项功能(Microsoft returns @removed 对于 10 天前删除的组)。或者这是一个错误?

我已经在我的实验室中对此进行了测试,并且在拨打电话时对我来说也是如此 GET /groups/delta 它为我提供了下一个 link 并且它还提供了我几天前删除的用户也从一个小组回来了。

因此,根据 Microsoft 文档, 预期会在第一个响应和下一个 link 中显示之前所做的删除:可以在初始增量查询响应中返回 @removed 对象并在跟踪的(deltaLink)响应中 并且可以在增量 link 响应中跟踪在增量调用之后所做的新更改。

参考: Use delta query to track changes in Microsoft Graph data - Microsoft Graph | Microsoft Docs

group: delta - Microsoft Graph v1.0 | Microsoft Docs

使用 Graph 资源管理器进行示例测试:

  1. 正在设置 delta 调用,作为响应,我得到了我的所有详细信息 Groups 和 nextlink 以获取更多详细信息,直到最后我得到 增量link.

  1. 我在初步回复后创建了一个用户到组中。

  1. 在 deltalink 响应中,我得到了添加的用户的详细信息。