如何通过Azure Rest API获取Azure DevOps Pipeline阶段详细进度？

可用的REST API端点 #

• 获取运行的阶段详情（含步骤状态）：使用Pipelines Runs - Get端点，加上$expand=stages,summaries参数，这个端点会返回每个阶段下的步骤执行状态、开始/结束时间、结果等详细信息。
  • 请求示例：

    GET https://dev.azure.com/{organization}/{project}/_apis/pipelines/runs/{runId}?api-version=7.0&$expand=stages,summaries
    

• 补充：获取阶段的任务详情：如果需要更细粒度的任务执行数据，可调用Build Timeline - Get端点，它会返回整个运行的时间线，包含所有阶段、作业、任务的状态、日志链接等信息。
  • 请求示例：

    GET https://dev.azure.com/{organization}/{project}/_apis/build/builds/{buildId}/timeline?api-version=7.0
    

关键参数说明 #

• $expand=stages,summaries：在Pipelines Runs - Get中使用该参数，会展开返回阶段的详细数据，包括每个阶段的状态（如InProgress、Succeeded）、步骤的执行状态及进度。
• buildId/runId：对应Pipeline运行实例的唯一ID，可从之前获取的运行记录接口中拿到。

注意事项 #

• 确保请求权限足够：需要Build (Read)或类似的权限才能访问这些端点的数据。
• 区分YAML Pipeline和经典Build：上述端点对两种类型的Pipeline都适用，但YAML Pipeline的阶段结构会在返回结果中以更清晰的层级展示。

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