如何获取Azure DevOps近7天失败代理池作业及事件时的扩展失败作业列表

一、通过Azure DevOps UI界面查询过去7天失败作业 #

• 登录Azure DevOps门户，进入对应项目
• 左侧导航栏选择Pipelines > Agent pools，选中目标代理池
• 切换到Jobs标签页，点击页面上方的筛选按钮：
  • 在Status筛选器里勾选Failed
  • 在Date range筛选器中选择Last 7 days，或者自定义起始日期为7天前
  • 点击Apply就能看到符合条件的失败作业列表

二、通过REST API实现灵活的历史失败作业查询 #

如果需要查询超过当日的失败作业，或者想自动化查询，用Azure DevOps REST API更合适：

1. 调用Agent作业列表接口 #

使用Agent Jobs - List接口，指定状态和时间范围参数：

GET https://dev.azure.com/{organization}/_apis/distributedtask/pools/{poolId}/jobs?api-version=7.1-preview.1&status=Failed&minTime={7天前UTC时间}&maxTime={当前UTC时间}

• 替换{organization}为你的组织名称
• {poolId}是目标代理池的ID（可在Agent pools页面的URL中找到）
• {7天前UTC时间}格式为yyyy-MM-ddTHH:mm:ssZ，比如2024-05-20T00:00:00Z

2. 认证说明 #

用个人访问令牌（PAT）进行认证，在请求头中添加：

Authorization: Basic {base64编码的PAT}

（PAT需要拥有**Agent Pools (Read)**权限）

三、长期留存失败作业记录的方案 #

如果需要随时查询历史失败作业，可通过以下方式实现：

• 调整作业保留策略：在项目设置的Pipelines > Settings中，修改Retention policies，延长失败作业的保留时长（默认保留时间较短）
• 自动化导出数据：用Azure Logic Apps或Power Automate定期调用上述API，把失败作业数据导出到Azure存储、Excel或数据库中，实现历史数据的留存和随时查询

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