Получить сборки из TFS-API используя top - Параметр - PullRequest
2 голосов
/ 08 апреля 2020

Я хочу получить список последних сборок моей TFS. API в целом работает хорошо - но я не понимаю работу параметра "$ top".

Если я использую простой вызов API без параметра top:

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 - только 10 из 1000.

Я неправильно понимаю параметр $ top-Parameter? Или это ошибка в TFS API?

1 Ответ

1 голос
/ 09 апреля 2020

Обновление

Извините за недоразумение. Это предусмотрено так же, как и описание. Он будет возвращать только максимальное количество сборок без порядка следования o f, чтобы возвращать результаты.

Другими словами, если вы используете параметр $ top, он извлечет 10 результатов всех результатов сборки, а затем упорядочит возвращенные 10 результатов. Сначала он не упорядочит все результаты сборки, а затем выберет топ-10 упорядоченных результатов сборки. Может быть, это и есть путаница.

То, что вы ищете, не доступно с существующим параметром. Вы могли получить только максимальную сумму в 1000 результатов с правильно упорядоченным первым. Наконец, принесите 10 из них.


Параметр $ top не работает как буквальное значение. Он просто вернет максимальное количество сборок .

$ top integer int32 Максимальное количество возвращаемых сборок.

Вы можете сослаться на официальный do c здесь: Builds - Список

...