使用 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
我想获取我的 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