Runs - Query

Service:

Test

API Version:

7.1-preview.3

Выполнение тестов запросов на основе фильтров. Обязательными полями являются minLastUpdatedDate и maxLastUpdatedDate.

GET https://dev.azure.com/{organization}/{project}/_apis/test/runs?minLastUpdatedDate={minLastUpdatedDate}&maxLastUpdatedDate={maxLastUpdatedDate}&api-version=7.1-preview.3

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/test/runs?minLastUpdatedDate={minLastUpdatedDate}&maxLastUpdatedDate={maxLastUpdatedDate}&state={state}&planIds={planIds}&isAutomated={isAutomated}&publishContext={publishContext}&buildIds={buildIds}&buildDefIds={buildDefIds}&branchName={branchName}&releaseIds={releaseIds}&releaseDefIds={releaseDefIds}&releaseEnvIds={releaseEnvIds}&releaseEnvDefIds={releaseEnvDefIds}&runTitle={runTitle}&$top={$top}&continuationToken={continuationToken}&api-version=7.1-preview.3

Параметры URI

Имя	В	Обязательно	Тип	Описание
organization	path	True	string	Название организации Azure DevOps.
project	path	True	string	Идентификатор проекта или имя проекта
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 7.1-preview.3.
maxLastUpdatedDate	query	True	string date-time	Максимальная дата последнего изменения запуска для запроса (обязательно, разница между минимальной и максимальной датой может составлять максимум 7 дней).
minLastUpdatedDate	query	True	string date-time	Минимальная дата последнего изменения запуска для запроса (обязательно).
$top	query		integer int32	Число выполнений, которые необходимо запрашивать. Ограничение — 100
branchName	query		string	Имя исходной ветви выполняется для запроса.
buildDefIds	query		string array (int32)	Идентификаторы определений сборки для запрашиваемых запусков, разделенные запятыми список допустимых идентификаторов (ограничение no. идентификаторов 10).
buildIds	query		string array (int32)	Идентификаторы сборки запрашиваемых запусков, разделенные запятыми список допустимых идентификаторов (ограничение no. идентификаторов 10).
continuationToken	query		string	continuationToken, полученный из предыдущего пакета, или значение NULL для первого пакета. Он не должен быть создан (или изменен, если он получен из последнего пакета) пользователем.
isAutomated	query		boolean	Тип автоматизации для запрашиваемых запусков.
planIds	query		string array (int32)	Идентификаторы плана запрашиваемых запусков, разделенный запятыми список допустимых идентификаторов (ограничение no. идентификаторов 10).
publishContext	query		TestRunPublishContext	PublishContext для выполнения запроса.
releaseDefIds	query		string array (int32)	Идентификаторы определения выпуска для запрашиваемых запусков, разделенные запятыми список допустимых идентификаторов (ограничение no. идентификаторов 10).
releaseEnvDefIds	query		string array (int32)	Идентификаторы определения среды выпуска для запрашиваемых запусков, разделенные запятыми список допустимых идентификаторов (ограничение no. идентификаторов 10).
releaseEnvIds	query		string array (int32)	Идентификаторы среды выпуска для запрашиваемых запусков, разделенные запятыми список допустимых идентификаторов (ограничение no. идентификаторов 10).
releaseIds	query		string array (int32)	Идентификаторы выпуска запрашиваемых запусков, разделенные запятыми, список допустимых идентификаторов (ограничение no. идентификаторов 10).
runTitle	query		string	Заголовок запуска для запрашиваемых запусков.
state	query		TestRunState	Текущее состояние запрашиваемых запусков.

Ответы

Имя	Тип	Описание
200 OK	TestRun[]	успешная операция

Безопасность

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Имя	Описание
vso.test	Предоставляет возможность считывать планы тестирования, варианты, результаты и другие артефакты, связанные с управлением тестированием.

Определения

Имя	Описание
BuildConfiguration	Сведения о сборкеКонфигурация.
CustomTestField	Сведения о настраиваемом поле. Allowed Key : Value pairs - ( AttemptId: int value, IsTestResultFlaky: bool)
DtlEnvironmentDetails	Это временный класс для предоставления сведений о среде тестового запуска.
IdentityRef
JobReference	Задание в конвейере. Это связано с матрицированием в YAML.
PhaseReference	Этап в конвейере
PipelineReference	Справочник по конвейеру
ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
ReleaseReference	Ссылка на выпуск.
ResultMetadata	ResultMetadata для заданного результата или счетчика.
RunFilter	Этот класс используется для предоставления фильтров, используемых для обнаружения.
RunStatistic	Статистика тестового выполнения для каждого результата.
ShallowReference	Абстрактная ссылка на какой-то другой ресурс. Этот класс используется для предоставления контрактам данных сборки единообразного способа ссылки на другие ресурсы таким образом, чтобы обеспечить простой обход по ссылкам.
StageReference	Этап в конвейере
TestEnvironment	Сведения о тестовой среде.
TestResolutionState	Сведения о состоянии разрешения теста.
TestRun	Сведения о тестовом запуске.
TestRunPublishContext	PublishContext для выполнения запроса.
TestRunState
TestRunSubstate	Типы вложенных состояний для тестового запуска.
TestTag	Тег, присоединенный к выполнению или результату.

BuildConfiguration

Сведения о сборкеКонфигурация.

Имя	Тип	Описание
branchName	string	Имя ветви, для которой создается сборка.
buildDefinitionId	integer	BuildDefinitionId для сборки.
buildSystem	string	Сборка системы.
creationDate	string	Дата создания сборки.
flavor	string	Вариант сборки (например, сборка или выпуск).
id	integer	BuildConfiguration Id.
number	string	Номер сборки.
platform	string	BuildConfiguration Platform.
project	ShallowReference	Проект, связанный с этой buildConfiguration.
repositoryGuid	string	Guid репозитория для сборки.
repositoryType	string	Тип репозитория (например, TFSGit).
sourceVersion	string	Была активирована исходная версия (/первая фиксация) для сборки.
targetBranchName	string	Имя целевой ветви.
uri	string	URI сборки.

CustomTestField

Сведения о настраиваемом поле. Allowed Key : Value pairs - ( AttemptId: int value, IsTestResultFlaky: bool)

Имя	Тип	Описание
fieldName	string	имя поля;
value	object	Значение поля.

DtlEnvironmentDetails

Это временный класс для предоставления сведений о среде тестового запуска.

Имя	Тип	Описание
csmContent	string
csmParameters	string
subscriptionName	string

IdentityRef

Имя	Тип	Описание
_links	ReferenceLinks	Это поле содержит ноль или более интересных ссылок на тему графа. Эти ссылки можно вызвать для получения дополнительных связей или более подробных сведений об этой теме графа.
descriptor	string	Дескриптор является основным способом ссылки на субъект графа во время работы системы. Это поле однозначно идентифицирует одну и ту же тему графа как в учетных записях, так и в организациях.
directoryAlias	string	Нерекомендуемый — можно получить, запросив пользователя Graph, на который ссылается запись self словаря IdentityRef _links.
displayName	string	Это неуникальное отображаемое имя субъекта графа. Чтобы изменить это поле, необходимо изменить его значение в поставщике источника.
id	string
imageUrl	string	Не рекомендуется — доступно в записи "аватар" словаря IdentityRef "_links"
inactive	boolean	Не рекомендуется — можно получить, запросив состояние членства Graph, указанное в записи membershipState словаря GraphUser _links.
isAadIdentity	boolean	Не рекомендуется — может выводиться из типа субъекта дескриптора (descriptor.IsAadUserType/descriptor.IsAadGroupType).
isContainer	boolean	Не рекомендуется — может выводиться из типа субъекта дескриптора (Descriptor.IsGroupType).
isDeletedInOrigin	boolean
profileUrl	string	Нерекомендуемый — не используется в большинстве уже существовающих реализаций ToIdentityRef.
uniqueName	string	Нерекомендуемый — используйте вместо этого домен+имя_субъекта
url	string	Этот URL-адрес является полным маршрутом к исходному ресурсу этого субъекта графа.

JobReference

Задание в конвейере. Это связано с матрицированием в YAML.

Имя	Тип	Описание
attempt	integer	Номер попытки задания
jobName	string	При матрице в YAML создаются копии задания с разными входными данными в матрице. JobName — это имя этих входных данных. Максимальная поддерживаемая длина имени — 256 символов.

PhaseReference

Этап в конвейере

Имя	Тип	Описание
attempt	integer	Номер попытки этапа
phaseName	string	Имя этапа. Максимальная поддерживаемая длина имени — 256 символов.

PipelineReference

Справочник по конвейеру

Имя	Тип	Описание
jobReference	JobReference	Справочник по заданию
phaseReference	PhaseReference	Ссылка на этап.
pipelineId	integer	Ссылка на конвейер, с которым связан этот экземпляр конвейера.
stageReference	StageReference	Ссылка на этап.

ReferenceLinks

Класс, представляющий коллекцию ссылок REST.

Имя	Тип	Описание
links	object	Представление ссылок только для чтения. Так как ссылочные ссылки доступны только для чтения, мы хотим предоставить их только для чтения.

ReleaseReference

Ссылка на выпуск.

Имя	Тип	Описание
attempt	integer	Число попыток выпуска.
creationDate	string	Дата создания выпуска (UTC).
definitionId	integer	Идентификатор определения выпуска.
environmentCreationDate	string	Дата создания среды (UTC).
environmentDefinitionId	integer	Идентификатор определения среды выпуска.
environmentDefinitionName	string	Имя определения среды выпуска.
environmentId	integer	Идентификатор среды выпуска.
environmentName	string	Имя среды выпуска.
id	integer	Идентификатор выпуска.
name	string	Имя выпуска.

ResultMetadata

ResultMetadata для заданного результата или счетчика.

Имя	Тип	Описание
flaky	string	Ненадежные метаданные
rerun	string	Повторный запуск метаданных

RunFilter

Этот класс используется для предоставления фильтров, используемых для обнаружения.

Имя	Тип	Описание
sourceFilter	string	фильтр для источников тестовых случаев (тестовые контейнеры)
testCaseFilter	string	фильтр для тестовых случаев

RunStatistic

Статистика тестового выполнения для каждого результата.

Имя	Тип	Описание
count	integer	Количество результатов теста для заданного результата.
outcome	string	Результат теста
resolutionState	TestResolutionState	Состояние разрешения тестового запуска.
resultMetadata	ResultMetadata	ResultMetadata для заданного результата или счетчика.
state	string	Состояние тестового запуска

ShallowReference

Абстрактная ссылка на какой-то другой ресурс. Этот класс используется для предоставления контрактам данных сборки единообразного способа ссылки на другие ресурсы таким образом, чтобы обеспечить простой обход по ссылкам.

Имя	Тип	Описание
id	string	Идентификатор ресурса
name	string	Имя связанного ресурса (имя определения, имя контроллера и т. д.)
url	string	Полная ссылка http на ресурс

StageReference

Этап в конвейере

Имя	Тип	Описание
attempt	integer	Число попыток этапа
stageName	string	Имя этапа. Максимальная поддерживаемая длина имени — 256 символов.

TestEnvironment

Сведения о тестовой среде.

Имя	Тип	Описание
environmentId	string	Идентификатор тестовой среды.
environmentName	string	Имя тестовой среды.

TestResolutionState

Сведения о состоянии разрешения теста.

Имя	Тип	Описание
id	integer	Идентификатор состояния разрешения теста.
name	string	Имя состояния разрешения теста.
project	ShallowReference	Абстрактная ссылка на какой-то другой ресурс. Этот класс используется для предоставления контрактам данных сборки единообразного способа ссылки на другие ресурсы таким образом, чтобы обеспечить простой обход по ссылкам.

TestRun

Сведения о тестовом запуске.

Имя	Тип	Описание
build	ShallowReference	Сборка, связанная с этим тестовом запуском.
buildConfiguration	BuildConfiguration	Сведения о конфигурации сборки, связанные с этим тестом.
comment	string	Комментарии, введенные теми, кто анализирует выполнение.
completedDate	string	Дата завершения выполнения.
controller	string	Контроллер тестового запуска.
createdDate	string	Тестовое выполнение CreatedDate.
customFields	CustomTestField[]	Список настраиваемых полей для TestRun.
dropLocation	string	Удалить расположение для тестового запуска.
dtlAutEnvironment	ShallowReference	Абстрактная ссылка на какой-то другой ресурс. Этот класс используется для предоставления контрактам данных сборки единообразного способа ссылки на другие ресурсы таким образом, чтобы обеспечить простой обход по ссылкам.
dtlEnvironment	ShallowReference	Абстрактная ссылка на какой-то другой ресурс. Этот класс используется для предоставления контрактам данных сборки единообразного способа ссылки на другие ресурсы таким образом, чтобы обеспечить простой обход по ссылкам.
dtlEnvironmentCreationDetails	DtlEnvironmentDetails	Это временный класс для предоставления сведений о среде тестового запуска.
dueDate	string	Дата и время выполнения теста.
errorMessage	string	Сообщение об ошибке, связанное с выполнением.
filter	RunFilter	Этот класс используется для предоставления фильтров, используемых для обнаружения.
id	integer	Идентификатор тестового запуска.
incompleteTests	integer	Количество неполных тестов.
isAutomated	boolean	Значение true, если тестовый запуск выполняется автоматически, в противном случае — false.
iteration	string	Итерация, которой принадлежит запуск.
lastUpdatedBy	IdentityRef	Team Foundation ID последнего обновленного тестового запуска.
lastUpdatedDate	string	Дата и время последнего обновления
name	string	Имя тестового запуска.
notApplicableTests	integer	Число неприменимых тестов.
owner	IdentityRef	Идентификатор Team Foundation владельца запусков.
passedTests	integer	Количество пройденных тестов в выполнении
phase	string	Этап или состояние для testRun.
pipelineReference	PipelineReference	Ссылка на конвейер, к которому принадлежит этот тестовый запуск.
plan	ShallowReference	План тестирования, связанный с этим тестового запуска.
postProcessState	string	Состояние после процесса.
project	ShallowReference	Проект, связанный с этим запуском.
release	ReleaseReference	Справочник по выпуску тестового запуска.
releaseEnvironmentUri	string	URI среды выпуска для TestRun.
releaseUri	string	URI выпуска для TestRun.
revision	integer
runStatistics	RunStatistic[]	RunSummary по результату.
startedDate	string	Дата начала выполнения.
state	string	Состояние выполнения. Допустимые состояния TestRunState — Unspecified , NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate	TestRunSubstate	TestRun Substate.
tags	TestTag[]	Теги, вложенные в этот тестовый запуск.
testEnvironment	TestEnvironment	Тестовая среда, связанная с выполнением.
testMessageLogId	integer
testSettings	ShallowReference	Абстрактная ссылка на какой-то другой ресурс. Этот класс используется для предоставления контрактам данных сборки единообразного способа ссылки на другие ресурсы таким образом, чтобы обеспечить простой обход по ссылкам.
totalTests	integer	Общее количество тестов в выполнении
unanalyzedTests	integer	Количество неудачных тестов в выполнении.
url	string	URL-адрес тестового запуска
webAccessUrl	string	URL-адрес веб-доступа для TestRun.

TestRunPublishContext

PublishContext для выполнения запроса.

Имя	Тип	Описание
all	string	Запуск публикуется для любого контекста.
build	string	Запуск опубликован для контекста сборки.
release	string	Запуск публикуется для контекста выпуска.

TestRunState

Имя	Тип	Описание
aborted	string	Выполнение остановлено, а остальные тесты прерваны
completed	string	Все тесты завершены или пропущены.
inProgress	string	Тесты выполняются.
needsInvestigation	string	Для выполнения требуется исследование из-за сбоя точки тестирования Это устаревшее состояние, которое больше не должно использоваться
notStarted	string	Запуск все еще создается. Тесты еще не начались.
unspecified	string	Используется только во время обновления для сохранения существующего значения.
waiting	string	Запуск в настоящее время инициализирует. Это устаревшее состояние, которое больше не должно использоваться

TestRunSubstate

Типы вложенных состояний для тестового запуска.

Имя	Тип	Описание
abortedBySystem	string	Состояние запуска, когда оно прервано системой.
analyzed	string	Состояние выполнения после анализа.
canceledByUser	string	Состояние выполнения при создании среды.
cancellationInProgress	string	Состояние выполнения при выполнении отмены.
creatingEnvironment	string	Состояние выполнения при создании среды.
none	string	Запуск с noState.
pendingAnalysis	string	Состояние выполнения при ожидании анализа.
runningTests	string	Состояние выполнения во время выполнения тестов.
timedOut	string	Состояние выполнения, если для выполнения установлено время ожидания.

TestTag

Тег, присоединенный к выполнению или результату.

Имя	Тип	Описание
name	string	Имя тега, буквенно-цифровое значение менее 30 символов