使用 top - 参数从 TFS-API 获取构建

Get builds from TFS-API using top - Parameter

我想获取我的 TFS 的最新版本列表。 API 总的来说效果很好——但我不明白“$top”参数的工作原理。

如果我使用不带顶级参数的简单 API 调用:

https://mytfs/project/_apis/build/builds?buildQueryOrder=finishTimeAscending

我得到了最大数量的 1000 个结果,正确排序为 top/first 上的最新结果。

如果我添加 $top-Parameter:

https://mytfs/project/_apis/build/builds?$top=10&buildQueryOrder=finishTimeAscending

我得到 10 个结果——但不是较大列表中的前 10 个——而是 10 个随机结果(但总是相同的 10 个——因此不是真正随机的)。但这不是最新的 10 个或最旧的 10 个 - 1000 个中只有 10 个。

我对 $top-Parameter 的理解有误吗?或者这是 TFS API 中的错误?

更新

抱歉造成误会。这是设计使然正如描述。它只会return构建的最大数量而不是顺序 of return 结果。

换句话说,如果你使用 $top 参数,它会获取所有构建结果中的 10 个结果,然后对这 10 个结果进行排序 return。它不会先对所有构建结果进行排序,然后获取排序后的前 10 个构建结果。也许这就是困惑所在。

对于您正在寻找的内容,现有参数不可用。如果先正确排序,您最多只能获得 1000 个结果。终于拿到了10个。


$top参数不是字面意思。它只会 return 最大构建数

$top integer int32 The maximum number of builds to return.

你可以在这里参考官方文档:Builds - List