调用REST API获取Azure DevOps检查配置列表时遇400错误

问题本质 #

尽管官方文档标记resourceType和resourceId为可选参数，但实际调用时这两个参数是必填项——接口需要明确指定资源范围才能返回数据，文档描述存在偏差。你测试的多个API版本（6.0/7.0/7.1）均出现该问题，说明这是接口的固有逻辑，而非版本bug。

解决步骤 #

1. 获取所需参数值 #

根据你要查询的检查配置所属资源类型，选择对应的方式获取ID：

• 管道（Pipeline）：
  • resourceType固定为pipeline
  • 管道ID可通过列表接口获取：

    GET https://dev.azure.com/{org}/{proj}/_apis/pipelines?api-version=7.1
    

• 环境（Environment）：
  • resourceType固定为environment
  • 环境ID可通过列表接口获取：

    GET https://dev.azure.com/{org}/{proj}/_apis/distributedtask/environments?api-version=7.1
    

• 服务连接（Service Connection）：
  • resourceType固定为endpoint
  • 服务连接ID可通过列表接口获取：

    GET https://dev.azure.com/{org}/{proj}/_apis/serviceendpoint/endpoints?api-version=7.1
    

2. 修正接口调用 #

在请求URL中携带resourceType和resourceId参数，示例请求：

GET https://dev.azure.com/{organization}/{project}/_apis/pipelines/checks/configurations?resourceType=pipeline&resourceId={你的管道ID}&api-version=7.1

补充提示 #

如果不确定目标检查配置属于哪种资源类型，可以先枚举项目内所有上述类型的资源，逐一尝试调用接口，直到返回有效数据。

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