如何使用Azure DevOps REST API获取用户所属团队？

要获取用户在Azure DevOps组织/项目设置菜单内的所属团队，目前没有直接的单接口可以通过userId/descriptor/displayName直接查询，需要分步骤调用API实现：

1. 核心流程 #

• 先确认目标用户的唯一标识（推荐用descriptor，不会随用户信息变更而失效；userId也可使用）
• 遍历组织内的所有项目
• 对每个项目，获取其下的所有团队
• 检查目标用户是否在对应团队的成员列表中

2. 具体API调用示例 #

获取用户身份信息（可选） #

如果还没有用户的userId或descriptor，可以通过邮箱查询：

GET https://vssps.dev.azure.com/{组织名}/_apis/graph/users?api-version=7.1-preview.1&$filter=principalName eq '{用户邮箱}'

返回结果会包含用户的id（即userId）和descriptor字段。

获取组织内所有项目 #

GET https://dev.azure.com/{组织名}/_apis/projects?api-version=7.1-preview.4

获取单个项目下的所有团队 #

对每个项目，用项目的id或名称调用：

GET https://dev.azure.com/{组织名}/{项目ID或名称}/_apis/teams?api-version=7.1-preview.3

检查用户是否属于某团队 #

对每个团队，用$filter直接过滤目标用户，减少无效数据返回：

GET https://dev.azure.com/{组织名}/{项目ID}/{团队ID}/_apis/teammembers?api-version=7.1-preview.3&$filter=id eq '{userId}'

如果响应里有成员数据，说明该用户属于这个团队。

3. 实用提示 #

• 权限要求：调用这些API需要拥有组织的Read权限，或者对应项目的Project Reader权限
• 性能优化：如果组织内项目和团队较多，建议异步处理请求，避免超时
• 标识选择：优先用descriptor，它是用户的全局唯一标识，比userId更稳定

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