Microsoft Graph /users接口使用endsWith筛选器不生效问题咨询

• Microsoft Graph v1.0版本的/users端点目前仅对userPrincipalName属性开放endsWith筛选能力，mail属性暂未在v1.0版本适配该运算符，即使按要求携带ConsistencyLevel: eventual请求头、添加$count=true参数也无法正常触发筛选。
• 你遇到的报错属于标准的属性不支持对应筛选运算符的错误提示，根据官方属性筛选规则，v1.0版本的mail属性仅支持eq、ne、in、startsWith四类筛选运算符，endsWith不在支持范围内。

• 方案1：切换到beta版本接口调用
  beta版本的/users端点已经完成mail属性的endsWith能力适配，调用时保持原有的请求头和$count=true参数即可，请求示例如下：

  GET https://graph.microsoft.com/beta/users?$count=true&$filter=endsWith(mail,'@hotmail.com')&$select=id,displayName,mail
  

  注意beta版本接口存在功能不稳定的可能，不建议直接用于生产环境核心逻辑。
• 方案2：本地二次筛选
  如果必须使用v1.0稳定版本，可以先拉取满足其他基础条件的全量用户数据，在本地对mail字段做后缀匹配筛选，该方案仅适用于租户用户规模较小的场景，避免拉取数据量过大导致性能损耗。
• 方案3：替换筛选属性
  如果你所在租户的用户userPrincipalName取值与mail完全一致，可以直接将筛选的属性替换为userPrincipalName，即可在v1.0版本正常使用endsWith筛选能力。

内容的提问来源于stack exchange，提问作者Zed