VSTS Test->Runs->Query端点无法按参数过滤问题咨询

我之前也踩过这个坑，Azure DevOps的测试运行查询API对参数格式和属性名称要求挺严格的，除了$top外其他参数失效大概率是参数用法不对。咱们来一步步解决：

• 确认$filter参数的正确写法
  要筛选关联特定发布的测试运行，必须用OData格式的$filter参数，指定测试运行的Release.Id属性等于你的发布ID。很多人容易写错属性名，比如直接用releaseId而不是嵌套的Release.Id。正确的筛选逻辑应该是：

  $filter=Release.Id eq {你的发布ID}
  

• 务必指定兼容的API版本
  旧版本的API可能不支持通过发布ID筛选测试运行，建议使用最新的预览版或正式版API，比如api-version=7.1-preview.3（或者更高版本）。完整的请求示例如下：

  GET https://dev.azure.com/YourOrganization/YourProject/_apis/test/runs?$filter=Release.Id eq 123&$top=14&api-version=7.1-preview.3
  

• 检查参数拼写和格式错误
  常见的错误包括：

  • 漏掉$filter前面的$符号，写成filter
  • 发布ID前后加了多余的引号（如果是数字ID不需要引号）
  • 路径或参数里有未编码的空格（比如项目名有空格，要编码成%20）

• 验证发布ID的准确性
  虽然你说已经获取了发布ID，但可以再通过发布API确认这个ID对应的发布确实关联了14个测试运行，避免拿错了ID。

如果按照上面的步骤调整后还是不行，建议用Azure DevOps自带的API Explorer来调试，它能实时返回错误提示，帮你定位问题。

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