如何从Azure DevOps分支策略的审批者ID获取审批人信息？

问题描述 #

通过调用以下API获取仓库默认分支的策略配置：

https://dev.azure.com/{organization}/{project}/_apis/git/policy/configurations?api-version=7.1-preview.1&repositoryId={repo_id}&refName={default_branch}

遍历结果找到显示名称为Required reviewers的条目后，其settings字段中的requiredReviewerIds是一组GUID，但无法将这些GUID关联到对应的用户或团队。

已尝试的方法 #

• userentitlements端点
  • 返回的用户ID与目标GUID匹配，但该端点不支持按ID筛选，需拉取全量数据才能查找
  • 无法获取团队/组相关信息
• https://vssps.dev.azure.com/{organization}/_apis/graph/users/{GUID}?api-version=7.1-preview
  • 端点返回的用户ID与策略配置中的GUID不匹配
  • 对应的/teams/端点无法找到目标团队，且返回的团队ID也不匹配

解决方案 #

策略中的requiredReviewerIds实际上是身份描述符(Identity Descriptor)，需要使用Azure DevOps Graph API的批量身份查询端点来关联：

https://vssps.dev.azure.com/{organization}/_apis/graph/identities?ids={GUID1},{GUID2}&api-version=7.1-preview.1

使用说明： #

1. 将需要查询的GUID以逗号分隔填入ids参数中，支持批量查询
2. 返回结果中会包含每个身份的displayName（显示名称）、subjectKind（区分是user还是group/team）等关键信息，直接对应策略中的必填审阅者
3. 该端点同时支持查询用户、项目团队、自定义组等所有类型的身份标识

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