Runs - Query

Служба:

Test

Версия API:

7.1

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

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

С использованием необязательных параметров:

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
organization	path	True	string	Имя организации Azure DevOps.
project	path	True	string	Идентификатор проекта или имя проекта
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение "7.1".
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))	Идентификаторы определения сборки для запросов, разделенные запятыми, разделенный списком допустимых идентификаторов (ограничение не ограничено идентификаторами 10).
buildIds	query		string (array (int32))	Идентификаторы сборки для запросов, разделенные запятыми допустимых идентификаторов (ограничение нет. идентификаторов 10).
continuationToken	query		string	continuationToken, полученный из предыдущего пакета или null для первого пакета. Он не должен быть создан (или изменен, если получен из последней пакетной службы) пользователем.
isAutomated	query		boolean	Тип автоматизации запуска, запрашиваемого.
planIds	query		string (array (int32))	Идентификаторы плана запросов, разделенные запятыми допустимых идентификаторов (ограничение не ограничено идентификаторами 10).
publishContext	query		TestRunPublishContext	PublishContext для запросов к запускам.
releaseDefIds	query		string (array (int32))	Идентификаторы определения выпуска для запросов, разделенные запятыми, список допустимых идентификаторов (ограничение нет. идентификаторов 10).
releaseEnvDefIds	query		string (array (int32))	Идентификаторы определения среды выпуска для запросов, разделенные запятыми, список допустимых идентификаторов (ограничение нет. идентификаторов 10).
releaseEnvIds	query		string (array (int32))	Идентификаторы среды выпуска для запросов, разделенные запятыми, список допустимых идентификаторов (ограничение нет. идентификаторов 10).
releaseIds	query		string (array (int32))	Идентификаторы выпуска запуска для запроса, разделенный запятыми допустимых идентификаторов (ограничение не ограничено идентификаторами 10).
runTitle	query		string	Заголовок запуска запуска для запроса.
state	query		TestRunState	Текущее состояние запросов к запускам.

Ответы

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

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

oauth2

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
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

Области

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

Определения

Имя	Описание
BuildConfiguration	Сведения о сборке.
CustomTestField	Сведения о настраиваемом поле. Разрешенный ключ: пары "Значение" ( 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

Object

Сведения о сборке.

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

CustomTestField

Object

Сведения о настраиваемом поле. Разрешенный ключ: пары "Значение" ( AttemptId: int value, IsTestResultFlaky: bool)

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

DtlEnvironmentDetails

Object

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

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

IdentityRef

Object

Имя	Тип	Описание
_links	ReferenceLinks	Это поле содержит нулевые или более интересные ссылки на тему графа. Эти ссылки могут вызываться для получения дополнительных связей или более подробных сведений об этой теме графа.
descriptor	string	Дескриптор является основным способом ссылки на тему графа во время выполнения системы. Это поле однозначно определяет одну и ту же тему графа как в учетных записях, так и в организациях.
directoryAlias	string	Нерекомендуемое. Можно получить, запросив пользователя Graph, на который ссылается пользователь 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	Не рекомендуется — вместо этого используйте domain+PrincipalName
url	string	Этот URL-адрес является полным маршрутом к исходному ресурсу данного субъекта графа.

JobReference

Object

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

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

PhaseReference

Object

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

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

PipelineReference

Object

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

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

ReferenceLinks

Object

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

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

ReleaseReference

Object

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

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

ResultMetadata

Перечисление

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

Значение	Описание
flaky	Метаданные Flaky
rerun	Повторное выполнение метаданных

RunFilter

Object

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

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

RunStatistic

Object

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

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

ShallowReference

Object

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

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

StageReference

Object

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

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

TestEnvironment

Object

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

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

TestResolutionState

Object

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

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

TestRun

Object

Сведения о тестовом выполнении.

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

TestRunPublishContext

Перечисление

PublishContext для запросов к запускам.

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

TestRunState

Перечисление

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

TestRunSubstate

Перечисление

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

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

TestTag

Object

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

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