如何通过Microsoft Graph编程列出自定义目录角色？过滤请求报错

问题分析 #

调用https://graph.microsoft.com/v1.0/roleManagement/directory/roleDefinitions接口时，使用$filter=isBuiltIn eq 'false'过滤自定义角色返回BadRequest错误，提示Invalid filter clause，核心原因是该端点的isBuiltIn字段不支持OData的$filter查询规则。

可行解决方案 #

方案1：客户端侧过滤 #

先请求获取全量目录角色数据，再在本地代码中筛选出isBuiltIn为false的条目。示例代码（以C#为例）：

var allRoles = await graphClient.RoleManagement.Directory.RoleDefinitions.GetAsync();
var customRoles = allRoles.Value.Where(r => !r.IsBuiltIn.GetValueOrDefault()).ToList();

方案2：通过支持过滤的字段间接筛选 #

自定义目录角色的templateId不会是内置角色的固定模板ID，不过这种方式通用性较弱。如果需要在服务端完成筛选，可尝试通过description或displayName等支持过滤的字段匹配自定义角色的特征，但仅适用于有统一命名/描述规范的场景。

验证说明 #

调用接口时不带$filter参数获取全量数据，确认返回结果中自定义角色的isBuiltIn字段值为false，再通过客户端逻辑过滤即可得到目标角色列表。

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