ADO API: Builds-List 不完整列表

ADO API: Builds-List incomplete list

我正在调用此 API 方法： https://docs.microsoft.com/en-us/rest/api/azure/devops/build/builds/list?view=azure-devops-rest-6.0#response

我的 API url（带占位符名称）： https://dev.azure.com/MyOrgName/MyProjName/_apis/build/builds?api-version=6.1-preview.6

结果大多是合适的，除了我得到一个过滤的构建列表，而且我似乎无法获得我想要的所有构建。特别是，来自几个管道的构建完全丢失了，我找不到任何方法来包含它们。没有明确的理由说明为什么包含某些构建，而某些不包含。

过滤器选项描述了我可以进一步减少它的方法，但这不是我的目标。我想检索我没有得到的构建。而且我不知道哪个我不知道的选项会让我得到我关心的结果。

正如您已经注意到的，每个 API 调用的响应正文中可以列出的对象数量是有上限的。一般情况下，如果你要列出的对象太多，会分页返回。

在每次调用的响应体中，一般都有一个参数'continuationToken'（见here）。您可以通过使用此参数调用 API 来访问下一个响应页面。

GET https://dev.azure.com/{organization}/{project}/_apis/build/builds?continuationToken={continuationToken}&api-version=6.1-preview.6

例如：

  • 第一次调用returns列表第一页；

  • 然后 运行 第二次调用在第一次调用的响应中返回参数 'continuationToken' 以获取第二页；

  • 然后使用第二个响应返回的'continuationToken'获取第三页；

    。 . .

  • 到最后一页了。

如果要遍历所有页面，可能需要循环调用API。