通过Azure DevOps API删除远程Git分支报错：不支持POST方法

核心问题修正 #

你遇到的"请求资源不支持POST方法"错误，本质是删除分支的请求参数不符合API规范，而非端点本身不支持POST。要通过pushes端点删除分支，必须在refUpdates中补充newObjectId字段并设置为Git删除分支的标准空对象SHA值。

修正后的curl命令 #

curl -X POST -u username:token -H "Content-Type: application/json" -d '{
  "refUpdates": [
    {
      "name": "refs/heads/{branchName}",
      "oldObjectId": "{objectId}",
      "newObjectId": "0000000000000000000000000000000000000000"
    }
  ]
}' "https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pushes?api-version=6.0-preview.1"

关键配置说明 #

• newObjectId必填项：必须设置为全零字符串0000000000000000000000000000000000000000，这是Git协议中标记删除分支引用的标准方式。
• oldObjectId校验：必须与服务器上目标分支的最新提交SHA完全匹配，否则会触发冲突错误，需先调用分支查询接口获取最新SHA值。
• 占位符替换：确保所有{branchName}、{objectId}、{organization}、{project}、{repositoryId}占位符已替换为实际值，分支名称无需重复添加refs/heads/前缀。

额外排查要点 #

• 权限检查：确认PAT令牌拥有**代码（读&写）**权限，部分场景下"完全访问"权限可能存在配置限制，直接指定代码权限更稳妥。
• 分支保护规则：如果目标分支是仓库默认分支或开启了保护规则，需先在Azure DevOps仓库设置中取消保护，否则无法通过API删除。
• 请求格式验证：确保JSON数据格式正确，无语法错误，可通过在线JSON校验工具提前验证。

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