如何通过VSTS REST API获取构建触发时所用的构建参数？

我之前也踩过这个坑！你用的/_apis/build/builds接口返回的基础构建信息里确实不会直接带出完整的构建触发参数，得通过扩展查询参数或者调用单个构建的详情接口来获取。

• 单个构建参数查询：
  针对特定构建ID，调用带$expand=parameters的接口，就能拿到触发时的所有参数（包括自定义参数、系统默认参数）：

  https://{accountName}.visualstudio.com/{project}/_apis/build/builds/{buildId}?$expand=parameters
  

  返回结果里会多出一个parameters字段，结构大概是这样的：

  "parameters": {
    "system.debug": "false",
    "myCustomParam": "triggerValue",
    "agent.os": "Windows_NT"
  }
  

• 批量获取多个构建的参数：
  如果想一次性拉取多个构建的参数，也可以在列表接口里加上$expand=parameters，同时建议用top参数限制返回数量避免数据过载：

  https://{accountName}.visualstudio.com/{project}/_apis/build/builds?$expand=parameters&top=20
  

• YAML构建的特殊情况：
  如果是YAML类型的构建，部分自定义参数可能会存在yamlParameters字段里，所以返回结果里可以同时查看parameters和yamlParameters两个字段来获取完整参数。

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