Microsoft Graph API-用户和组上每个增量查询的页面大小是多少?

时间:2018-07-12 00:19:51

标签: microsoft-graph

每个增量查询的页面大小是多少?

https://developer.microsoft.com/en-us/graph/docs/concepts/delta_query_users https://developer.microsoft.com/en-us/graph/docs/concepts/delta_query_groups

我的理解是$ top不适用于用户和组的增量查询。因此,我们无法设置自定义页面大小。

1 个答案:

答案 0 :(得分:0)

TL; DR :对于增量查询,页面大小不固定/不保证。有Prefer: odata.maxpagesize=X参数,但不适用于所有查询。


如果您尝试使用以下方法在Graph Explorer中重现这种情况:

https://graph.microsoft.com/v1.0/me/calendarView/delta?startDateTime=2010-01-01 00:00:00&endDateTime=2020-01-01 00:00:00&$top=5

它将给您以下错误:

  

'CalendarView'资源的更改跟踪不支持'$ top'参数,因为不能保证页面大小。改用Prefer:odata.maxpagesize =标头来表示页面大小首选项。

如本错误所述,无法保证页面大小。但是,通过添加其他标题

Prefer: odata.maxpagesize=10

您将看到仅返回10个结果。

一句话-某些资源(您询问的资源-用户和组)不支持此参数。

要查看是否支持对其他资源的增量查询,请转到this page,选择API,然后转到其文档中的 Request headers 段落。如果您在说明中找到带有odata.maxpagesize={x}. Optional.的标头-则受支持。

对于今天('18年7月),以下API支持odata.maxpagesize参数:事件,mailFolder,消息,contactFolder,联系人,以下支持:组,用户,driveItem,plannerUser。

随意使用Graph Explorer,因为它可能对故障排除很有帮助。