我想获取我的TFS的最新版本的列表。该API通常效果很好-但我不理解“ $ top”参数的工作方式。
如果我使用不带top参数的简单API调用:
https://mytfs/project/_apis/build/builds?buildQueryOrder=finishTimeAscending
我得到的最大数量为1000个结果,按正确的顺序排列,最新的放在顶部/第一位。
如果我添加$ top-Parameter:
https://mytfs/project/_apis/build/builds?$top=10&buildQueryOrder=finishTimeAscending
我得到10个结果-但不是从较大列表中的前10个结果-而是10个随机结果(但总是10个相同-因此不是真正随机的)。但这不是最新的10个,也不是最旧的10个-仅千分之十。
我是否理解$ top-Parameter错误?还是这是TFS API中的错误?
更新资料
很抱歉对于这个误会。正如描述,这是设计使然。它只会返回最大的构建数,而不会按返回结果的顺序排列。
换句话说,如果使用$ top参数,它将获取所有构建结果的10个结果,然后对返回的10个结果进行排序。它不会先订购所有构建结果,然后再获取订购的构建结果的前10名。也许这就是混乱所在。
对于您要寻找的内容,现有参数不可用。您最多只能获得1000个结果的最大数量,并且顺序正确。最终获取其中的10个。
$ top参数不能用作文字含义。它只会返回最大构建数。
$ top integer int32要返回的最大内部版本数。
您可以在此处参考官方文档:构建-列表
本文收集自互联网,转载请注明来源。
如有侵权,请联系[email protected] 删除。
我来说两句