能否通过REST API更新Azure Pipelines手动/计划构建默认分支？

你之前用错了API——Update Build是针对单个构建运行实例的，而流水线本身的默认分支配置需要用流水线更新API来操作，具体步骤如下：

1. 获取当前流水线的完整配置
   先调用GET接口拿到流水线的现有配置，避免覆盖其他重要设置：

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

2. 修改默认分支字段
   在返回的JSON中找到configuration.defaultBranch字段，将其值修改为目标分支的完整引用格式（必须带refs/heads/前缀，比如refs/heads/feature/new-default-branch），保留其他所有原有配置字段不变。

3. 提交更新请求
   用PUT接口将修改后的配置提交回去：

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

请求体就是你修改后的完整流水线JSON，关键部分示例：

{
  "name": "你的流水线名称",
  "configuration": {
    "defaultBranch": "refs/heads/your-target-branch",
    "repository": {
      // 原有仓库配置，无需修改
    },
    "path": "/azure-pipelines.yml",
    // 其他原有配置项
  }
}

关键注意事项 #

• 分支必须使用完整的Git引用格式，不能只写分支名，否则API会报错
• 确保使用的API版本是7.1-preview.1或更高版本，旧版本可能不支持该字段
• 操作账号需要拥有流水线的编辑权限（比如Build Administrator角色）

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