如何通过Azure DevOps REST API获取特定阶段的最新Build编号

算力阿峰

2026-8-16

获取Azure DevOps多阶段管道特定成功阶段的最新Build编号

步骤1：获取目标管道ID

你可以直接从Azure DevOps门户的管道URL中提取pipelineId（比如URL路径/pipelines/{pipelineId}/...中的数字），也可以通过API查询所有管道来定位：

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

返回结果中找到对应YAML管道的id字段即可。

步骤2：调用API筛选符合条件的运行记录

使用以下API请求，筛选出包含指定阶段（如QA）成功的管道运行，并按创建时间倒序取第一条：

GET https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs?api-version=7.1-preview.1&$expand=stages&$filter=stages/any(s: s/name eq 'QA' and s/status eq 'succeeded')&$orderby=createdDate desc&$top=1

请求授权说明

必须在请求头中添加授权信息：

Authorization: Basic {base64编码内容}
（将你的PAT令牌前缀加:后做Base64编码，比如执行echo -n ":your_pat_token" | base64生成编码值）

步骤3：提取目标Build编号

返回的JSON结果中，value数组的第一条记录里，buildNumber字段就是你需要的最新成功部署阶段对应的Build编号。同时可通过stages数组确认目标阶段的状态为succeeded。

示例响应片段

{
  "value": [
    {
      "buildNumber": "20240520.1",
      "createdDate": "2024-05-20T12:34:56.789Z",
      "stages": [
        {
          "name": "Dev",
          "status": "succeeded"
        },
        {
          "name": "QA",
          "status": "succeeded"
        }
      ]
    }
  ]
}