关于无法通过VSTS API创建项目级安全组的技术咨询

我之前也踩过这个坑！用VSTS（现在叫Azure DevOps）API创建项目级安全组，和集合级的核心区别其实就在两个关键地方——API端点的上下文，还有请求体里的项目范围参数，咱们一步步来解决：

1. 选对API端点是核心 #

集合级安全组是直接在组织根路径下调用/_apis/identityGroups，但项目级必须绑定到具体项目的上下文，正确的端点格式是：

https://dev.azure.com/{organization}/{project}/_apis/identityGroups?api-version=7.1-preview.1

一定要把{project}替换成你的项目名称或ID，确保请求是针对目标项目发起的——这是最容易忽略的点，也是导致你创建出集合级组的主要原因。

2. 请求体必须指定项目范围属性 #

除了displayName、description这些基础字段，你需要在properties里明确添加ScopeId（项目的GUID），示例请求体如下：

{
  "displayName": "项目专属测试组",
  "description": "仅用于当前项目的测试权限组",
  "properties": {
    "ScopeId": "12345678-1234-1234-1234-1234567890AB", // 替换为你的项目ID
    "ScopeName": "MyTestProject" // 可选，但能让组的属性更清晰
  }
}

项目ID可以从项目设置页面的URL里获取，或者调用项目列表APIhttps://dev.azure.com/{organization}/_apis/projects?api-version=7.1-preview.4来获取。

3. 确保权限足够 #

你使用的PAT（个人访问令牌）必须拥有项目级的Identity（身份）权限，至少要勾选“Read & Manage”。如果权限不足，API可能会静默降级为创建集合级组，或者直接返回403错误。

4. 验证创建结果 #

创建完成后，可以调用项目级的组列表API确认：

https://dev.azure.com/{organization}/{project}/_apis/identityGroups?api-version=7.1-preview.1

返回结果中，组的scope字段应该显示为你的项目ID，而不是组织集合的ID，这就说明创建成功了。

• 直接查看Azure DevOps官方REST API文档中“Identity Groups”的项目级相关章节，里面有完整的请求/响应示例，还有每个参数的详细说明。
• 在Azure DevOps社区论坛或Microsoft Q&A中搜索类似问题，很多开发者分享了PowerShell、Python、C#等不同语言的调用代码示例。
• 用文档页面右上角的“Try it”在线测试工具，直接模拟项目级组的创建请求，实时查看请求和响应细节，方便快速排查问题。

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