通过API设置Azure DevOps Pipeline权限时仓库ID报错求助

问题原因 #

Pipeline权限API对Git仓库资源的ID格式要求与环境、服务连接等资源不同：

• 环境、服务连接等资源可直接使用GUID作为ID
• Git仓库需要使用特定的完整标识符格式，而非单纯的仓库GUID

解决方案步骤 #

1. 获取项目ID #

先调用项目信息API获取当前项目的ID：

$org = "你的组织名"
$proj = "你的项目名"
$pat = "你的个人访问令牌"

$projectResponse = Invoke-RestMethod -Uri "https://dev.azure.com/$org/$proj/_apis/projects?api-version=7.0" -Headers @{Authorization = "Basic $([System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes(":$pat")))"}
$projectId = $projectResponse.value.id

2. 构造正确的仓库资源ID #

使用项目ID + 仓库GUID的组合作为资源ID，格式为：{projectId}/{repoId}

3. 修改请求体并重新调用API #

更新后的JSON请求体示例：

[
  {
    "resource": {
      "type": "repository",
      "id": "{projectId}/a0946c7f-e505-48be-ba1b-1044d4128a4e",
      "name": "Source"
    },
    "pipelines": [
      {
        "id": 2436,
        "authorized": true
      }
    ]
  }
]

验证GET请求 #

修改后的GET请求URL应为：

https://dev.azure.com/{organization}/{project}/_apis/pipelines/pipelinepermissions/repository/{projectId}/a0946c7f-e505-48be-ba1b-1044d4128a4e?api-version=7.0-preview.1

其他可行格式 #

如果上述组合ID仍无效，可尝试以下两种格式：

• 使用仓库的完整名称（项目名/仓库名），例如："id": "你的项目名/Source"
• 使用仓库的VSTFS URI格式："id": "vstfs:///Git/Repository/a0946c7f-e505-48be-ba1b-1044d4128a4e"

关键说明 #

Pipeline权限API针对不同资源类型的ID格式规则不一致，Git仓库的权限配置需要严格遵循其特定的ID格式要求，这是单纯使用仓库GUID报错的核心原因。

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