ADO Display job requests API携带includeCapabilities与demands参数的问询

核心结论 #

/distributedtask/pools/{poolId}/jobrequests 接口支持通过 includeCapabilities=true 和 demands 参数筛选并返回包含能力信息的作业请求，但需要修正路径和参数格式问题。

关键修正点 #

• 路径必须去掉项目（project）部分
  该接口属于组织级API，带project的路径会导致接口解析异常，正确基础路径为：

  https://dev.azure.com/{org}/_apis/distributedtask/pools/{poolId}/jobrequests?api-version=7.0
  

• 修正demands参数格式
  你的写法不符合API规范，正确格式是用冒号分隔键值对，而非-equals：

  demands=key:value
  

  多条件需求用逗号分隔，例如：demands=os:Windows,agent.name:MyAgent

• includeCapabilities参数验证
  该参数有效且大小写敏感，设置为true时，返回结果会包含代理能力相关字段，确保拼写无误。

正确请求示例 #

https://dev.azure.com/{org}/_apis/distributedtask/pools/{poolId}/jobrequests?api-version=7.0&includeCapabilities=true&demands=key:value

排查建议 #

如果仍无预期结果，检查以下几点：

• 确认代理池ID（poolId）为目标池的有效ID
• 目标池内是否存在匹配demands条件的作业请求
• 调用账号是否拥有该代理池的读取权限
• API版本7.0为稳定版本，无需更换

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