如何通过Azure DevOps API用最小参数更新构建定义defaultBranch

我之前也踩过这个坑！Azure DevOps的Build Definitions Update API（PUT方法）看起来支持部分更新，但实际上如果只传defaultBranch字段，哪怕返回200状态码也不会生效——因为它需要几个核心标识字段来精准定位要修改的构建定义，同时要确保版本一致性。

你需要传递的最小参数列表 #

要让更新生效，必须包含以下核心字段加上你要修改的defaultBranch：

• id：目标构建定义的唯一ID，API靠它确定要更新哪个定义
• revision：当前构建定义的修订版本号，这个是关键！Azure DevOps用它来处理并发更新，如果版本号不匹配，更新会静默失败或者返回冲突
• name：构建定义的名称，虽然看似无关，但如果不传，API可能无法识别这是一个更新操作
• defaultBranch：你要设置的新分支路径，必须是完整的引用格式（比如refs/heads/main，不能只写main）

示例请求体 #

{
  "id": 123,
  "revision": 5,
  "name": "我的构建定义",
  "defaultBranch": "refs/heads/main"
}

为什么之前的请求没生效？ #

你之前只传递defaultBranch的话，API无法确定要更新哪个构建定义，而且缺少revision字段的情况下，系统会认为这不是一个有效的更新请求——虽然返回200，但实际上没有执行任何修改。另外要注意分支路径的格式，必须带refs/heads/前缀，否则系统无法识别正确的分支。

小技巧：获取正确的revision和id #

你可以先调用Build Definitions的GET API获取目标构建定义的完整信息，从中提取id、revision和name字段，这样就能保证参数的准确性，避免版本不匹配的问题。

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