调用Azure DevOps发布REST API创建版本返回400错误排查求助

第一步：获取详细错误信息 #

你当前curl命令中的-f参数会在接口返回4xx/5xx状态码时直接截断响应输出，先去掉该参数重新执行请求，就能看到Azure DevOps返回的具体错误描述，明确是字段缺失、参数非法还是权限问题。

第二步：补全请求必填字段 #

你当前只传了definitionId，缺失了必填的artifacts字段，这是这类400错误最常见的诱因。所有关联了制品源（构建流水线、代码仓库等）的发布管道，创建发布时都需要指定对应的制品版本信息：

• 制品的alias可以在发布管道编辑页的「制品」配置区查看「源别名」，直接复制即可
• instanceReference.id为你要使用的制品版本ID，以构建流水线作为制品源时，该值对应具体的构建运行ID
  修改后的请求体示例：

{
  "definitionId": 27,
  "description": "Triggered by local",
  "isDraft": false,
  "artifacts": [
    {
      "alias": "你的发布管道配置的制品别名",
      "instanceReference": {
        "id": "制品版本ID"
      }
    }
  ]
}

其他排查项 #

• 如果发布管道配置了必填的自定义变量，需要在请求体中新增variables字段，传入所有必填变量的取值
• 确认你的PAT拥有对应项目的发布创建权限，权限范围需要包含发布的读写权限
• 确认请求URL中的组织名、项目名拼写完全正确，Azure DevOps接口路径对大小写敏感

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