Azure DevOps Server 2022本地版REST API获取组成员遇404问题

核心原因 #

你尝试的groupentitlements是Azure DevOps云端服务专属的API接口，本地部署的Azure DevOps Server 2022并不支持该接口，这是导致404错误的根本原因。本地服务器需要使用Graph API来查询组及成员信息。

正确的实现步骤 #

1. 获取目标组的Graph ID #

首先需要通过组名称查询到对应的Graph ID，使用以下接口：

GET http://192.168.0.1:8080/tfs/_apis/Graph/Groups?api-version=7.0&$filter=displayName eq '{你的组名}'

• 替换{你的组名}为实际组名称，比如DefaultCollection\\Project Administrators（注意反斜杠需要转义）。
• 响应结果中的id字段即为该组的Graph ID。

2. 根据组ID查询成员列表 #

使用第一步获取的组ID，调用成员查询接口获取组内用户信息：

GET http://192.168.0.1:8080/tfs/_apis/Graph/Memberships/{组的Graph ID}?api-version=7.0

• 响应结果中，value数组里的每个member对象包含用户的详细信息（如ID、名称、邮箱等）。

关键注意事项 #

• 本地Azure DevOps Server无需在域名前添加vssps.或vsaex.前缀，云端的域名前缀规则不适用于本地部署版本。
• API版本推荐使用7.0或7.1，这两个版本完全适配Azure DevOps Server 2022的功能。
• 确保调用接口的账号拥有目标组所在集合的读取权限，权限不足会返回403错误而非404。

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