Runs - Query

Usługa:

Test

Wersja interfejsu API:

7.1

Testy zapytań są uruchamiane na podstawie filtrów. Obowiązkowe pola to minLastUpdatedDate i maxLastUpdatedDate.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
project	path	True	string	Identyfikator projektu lub nazwa projektu
api-version	query	True	string	Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API.
maxLastUpdatedDate	query	True	string (date-time)	Maksymalna data ostatniej modyfikacji przebiegu do wykonania zapytania (obowiązkowe, różnica między minimalną i maksymalną datą może wynosić maksymalnie 7 dni).
minLastUpdatedDate	query	True	string (date-time)	Minimalna data ostatniej modyfikacji przebiegu do wykonania zapytania (obowiązkowe).
$top	query		integer (int32)	Liczba przebiegów do odpytowania. Limit to 100
branchName	query		string	Nazwa gałęzi źródłowej przebiegów do odpytowania.
buildDefIds	query		string (array (int32))	Identyfikatory definicji kompilacji przebiegów do wykonania zapytania, rozdzielona przecinkami lista prawidłowych identyfikatorów (nie ma limitu identyfikatorów 10).
buildIds	query		string (array (int32))	Identyfikatory kompilacji przebiegów do wykonania zapytania, rozdzielona przecinkami lista prawidłowych identyfikatorów (limit nr identyfikatorów 10).
continuationToken	query		string	continuationToken odebrany z poprzedniej partii lub null dla pierwszej partii. Nie ma zostać utworzony (lub zmieniony, jeśli otrzymany z ostatniej partii) przez użytkownika.
isAutomated	query		boolean	Typ automatyzacji przebiegów do odpytowania.
planIds	query		string (array (int32))	Identyfikatory planu przebiegów do odpytowania, rozdzielona przecinkami lista prawidłowych identyfikatorów (nie ma limitu identyfikatorów 10).
publishContext	query		TestRunPublishContext	Funkcja PublishContext przebiegów do odpytowania.
releaseDefIds	query		string (array (int32))	Identyfikatory definicji wydania przebiegów do odpytowania, rozdzielona przecinkami lista prawidłowych identyfikatorów (limit nr identyfikatorów 10).
releaseEnvDefIds	query		string (array (int32))	Identyfikatory definicji środowiska wydania dla przebiegów do odpytowania, rozdzielone przecinkami listę prawidłowych identyfikatorów (limit nr identyfikatorów 10).
releaseEnvIds	query		string (array (int32))	Identyfikatory środowiska wydania przebiegów do odpytowania, rozdzielona przecinkami lista prawidłowych identyfikatorów (limit nr identyfikatorów 10).
releaseIds	query		string (array (int32))	Identyfikatory wydania przebiegów do odpytowania, rozdzielona przecinkami lista prawidłowych identyfikatorów (limit nr identyfikatorów 10).
runTitle	query		string	Uruchom tytuł przebiegów do odpytowania.
state	query		TestRunState	Bieżący stan przebiegów do odpytowania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	TestRun[]	operacja zakończona powodzeniem

Zabezpieczenia

oauth2

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: 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

Zakresy

Nazwa	Opis
vso.test	Umożliwia odczytywanie planów testów, przypadków, wyników i innych artefaktów związanych z zarządzaniem testami.

Definicje

Nazwa	Opis
BuildConfiguration	Szczegóły konfiguracji kompilacji.
CustomTestField	Informacje o polu niestandardowym. Dozwolony klucz: pary wartości — ( AttemptId: wartość int, IsTestResultFlaky: bool)
DtlEnvironmentDetails	Jest to tymczasowa klasa, która udostępnia szczegółowe informacje dotyczące środowiska uruchomieniowego testu.
IdentityRef
JobReference	Zadanie w potoku. Jest to związane z macierzą w języku YAML.
PhaseReference	Faza w potoku
PipelineReference	Dokumentacja potoku
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
ReleaseReference	Odwołanie do wydania.
ResultMetadata	ResultMetadata dla danego wyniku/liczby.
RunFilter	Ta klasa służy do dostarczania filtrów używanych do odnajdywania
RunStatistic	Statystyki przebiegu testu na wynik.
ShallowReference	Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji z jednolity sposób odwołowania się do innych zasobów w sposób zapewniający łatwy przechodzenie przez łącza.
StageReference	Etap w potoku
TestEnvironment	Szczegóły środowiska testowego.
TestResolutionState	Szczegóły stanu rozwiązania testu.
TestRun	Szczegóły przebiegu testu.
TestRunPublishContext	Funkcja PublishContext przebiegów do odpytowania.
TestRunState
TestRunSubstate	Typy stanów podrzędnych dla przebiegu testu.
TestTag	Tag dołączony do przebiegu lub wyniku.

BuildConfiguration

Objekt

Szczegóły konfiguracji kompilacji.

Nazwa	Typ	Opis
branchName	string	Nazwa gałęzi, dla której jest generowana kompilacja.
buildDefinitionId	integer (int32)	BuildDefinitionId dla kompilacji.
buildSystem	string	System kompilacji.
creationDate	string (date-time)	Data utworzenia kompilacji.
flavor	string	Smak kompilacji (np. kompilacja/wydanie).
id	integer (int32)	Identyfikator kompilacjikonfiguracji.
number	string	Numer kompilacji.
platform	string	BuildConfiguration Platform.
project	ShallowReference	Projekt skojarzony z tą konfiguracją kompilacji.
repositoryGuid	string	Identyfikator GUID repozytorium dla kompilacji.
repositoryType	string	Typ repozytorium (np. TFSGit).
sourceVersion	string	Wersja źródłowa (/pierwsze zatwierdzenie) dla kompilacji została wyzwolona.
targetBranchName	string	Nazwa gałęzi docelowej.
uri	string	Identyfikator URI kompilacji.

CustomTestField

Objekt

Informacje o polu niestandardowym. Dozwolony klucz: pary wartości — ( AttemptId: wartość int, IsTestResultFlaky: bool)

Nazwa	Typ	Opis
fieldName	string	Nazwa pola.
value	object	Wartość pola.

DtlEnvironmentDetails

Objekt

Jest to tymczasowa klasa, która udostępnia szczegółowe informacje dotyczące środowiska uruchomieniowego testu.

Nazwa	Typ	Opis
csmContent	string
csmParameters	string
subscriptionName	string

IdentityRef

Objekt

Nazwa	Typ	Opis
_links	ReferenceLinks	To pole zawiera zero lub więcej interesujących linków dotyczących tematu grafu. Te linki mogą być wywoływane w celu uzyskania dodatkowych relacji lub bardziej szczegółowych informacji na temat tego tematu grafu.
descriptor	string	Deskryptor jest podstawowym sposobem odwołowania się do tematu grafu podczas działania systemu. To pole będzie jednoznacznie identyfikować ten sam temat grafu zarówno w ramach kont, jak i organizacji.
directoryAlias	string	Przestarzałe — można go pobrać, wykonując zapytanie względem użytkownika programu Graph, do których odwołuje się wpis "self" słownika IdentityRef "_links"
displayName	string	Jest to unikatowa nazwa wyświetlana podmiotu grafu. Aby zmienić to pole, musisz zmienić jego wartość u dostawcy źródłowego.
id	string
imageUrl	string	Przestarzałe — dostępne we wpisie "avatar" słownika IdentityRef "_links"
inactive	boolean	Przestarzałe — można pobrać, wykonując zapytanie dotyczące stanu członkostwa programu Graph, do których odwołuje się wpis "membershipState" słownika GraphUser "_links"
isAadIdentity	boolean	Przestarzałe — można wywnioskować z typu podmiotu deskryptora (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Przestarzałe — można wywnioskować z typu podmiotu deskryptora (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Przestarzałe — nie jest używane w większości istniejących implementacji elementu ToIdentityRef
uniqueName	string	Przestarzałe — zamiast tego użyj nazwy głównej i domeny
url	string	Ten adres URL jest pełną trasą do zasobu źródłowego tego tematu grafu.

JobReference

Objekt

Zadanie w potoku. Jest to związane z macierzą w języku YAML.

Nazwa	Typ	Opis
attempt	integer (int32)	Liczba prób zadania
jobName	string	Macierz w języku YAML generuje kopie zadania z różnymi danymi wejściowymi w macierzy. JobName to nazwa tych danych wejściowych. Maksymalna obsługiwana długość nazwy to 256 znaków.

PhaseReference

Objekt

Faza w potoku

Nazwa	Typ	Opis
attempt	integer (int32)	Liczba prób fazy
phaseName	string	Nazwa fazy. Maksymalna obsługiwana długość nazwy to 256 znaków.

PipelineReference

Objekt

Dokumentacja potoku

Nazwa	Typ	Opis
jobReference	JobReference	Odwołanie do zadania
phaseReference	PhaseReference	Odwołanie do fazy.
pipelineId	integer (int32)	Odwołanie do potoku, z którym jest powiązane to wystąpienie potoku.
stageReference	StageReference	Odwołanie do etapu.

ReferenceLinks

Objekt

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Czytelny widok linków. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

ReleaseReference

Objekt

Odwołanie do wydania.

Nazwa	Typ	Opis
attempt	integer (int32)	Liczba prób wydania.
creationDate	string (date-time)	Data utworzenia wydania (UTC).
definitionId	integer (int32)	Identyfikator definicji wydania.
environmentCreationDate	string (date-time)	Data utworzenia środowiska (UTC).
environmentDefinitionId	integer (int32)	Identyfikator definicji środowiska wydania.
environmentDefinitionName	string	Nazwa definicji środowiska wydania.
environmentId	integer (int32)	Identyfikator środowiska wydania.
environmentName	string	Nazwa środowiska wydania.
id	integer (int32)	Identyfikator wydania.
name	string	Nazwa wydania.

ResultMetadata

Wyliczanie

ResultMetadata dla danego wyniku/liczby.

Wartość	Opis
flaky	Flaky metadata (Flaky metadata)
rerun	Ponowne uruchamianie metadanych

RunFilter

Objekt

Ta klasa służy do dostarczania filtrów używanych do odnajdywania

Nazwa	Typ	Opis
sourceFilter	string	filtrowanie źródeł przypadków testowych (kontenery testowe)
testCaseFilter	string	filtrowanie przypadków testowych

RunStatistic

Objekt

Statystyki przebiegu testu na wynik.

Nazwa	Typ	Opis
count	integer (int32)	Liczba wyników testu dla danego wyniku.
outcome	string	Wynik testu
resolutionState	TestResolutionState	Stan rozwiązywania przebiegu testu.
resultMetadata	ResultMetadata	ResultMetadata dla danego wyniku/liczby.
state	string	Stan przebiegu testu

ShallowReference

Objekt

Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji z jednolity sposób odwołowania się do innych zasobów w sposób zapewniający łatwy przechodzenie przez łącza.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu
name	string	Nazwa połączonego zasobu (nazwa definicji, nazwa kontrolera itp.)
url	string	Pełny link http do zasobu

StageReference

Objekt

Etap w potoku

Nazwa	Typ	Opis
attempt	integer (int32)	Liczba prób etapu
stageName	string	Nazwa etapu. Maksymalna obsługiwana długość nazwy to 256 znaków.

TestEnvironment

Objekt

Szczegóły środowiska testowego.

Nazwa	Typ	Opis
environmentId	string (uuid)	Identyfikator środowiska testowego.
environmentName	string	Nazwa środowiska testowego.

TestResolutionState

Objekt

Szczegóły stanu rozwiązania testu.

Nazwa	Typ	Opis
id	integer (int32)	Identyfikator stanu rozwiązania testu.
name	string	Nazwa stanu rozwiązania testu.
project	ShallowReference	Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji z jednolity sposób odwołowania się do innych zasobów w sposób zapewniający łatwy przechodzenie przez łącza.

TestRun

Objekt

Szczegóły przebiegu testu.

Nazwa	Typ	Opis
build	ShallowReference	Kompilacja skojarzona z tym przebiegiem testu.
buildConfiguration	BuildConfiguration	Szczegóły konfiguracji kompilacji skojarzone z tym przebiegiem testu.
comment	string	Komentarze wprowadzone przez osoby analizujące przebieg.
completedDate	string (date-time)	Ukończono datę uruchomienia.
controller	string	Kontroler przebiegu testu.
createdDate	string (date-time)	Data utworzenia przebiegu testu.
customFields	CustomTestField[]	Lista pól niestandardowych dla elementu TestRun.
dropLocation	string	Upuść lokalizację dla przebiegu testu.
dtlAutEnvironment	ShallowReference	Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji z jednolity sposób odwołowania się do innych zasobów w sposób zapewniający łatwy przechodzenie przez łącza.
dtlEnvironment	ShallowReference	Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji z jednolity sposób odwołowania się do innych zasobów w sposób zapewniający łatwy przechodzenie przez łącza.
dtlEnvironmentCreationDetails	DtlEnvironmentDetails	Jest to tymczasowa klasa, która udostępnia szczegółowe informacje dotyczące środowiska uruchomieniowego testu.
dueDate	string (date-time)	Data i godzina ukończenia przebiegu testu.
errorMessage	string	Komunikat o błędzie skojarzony z przebiegiem.
filter	RunFilter	Ta klasa służy do dostarczania filtrów używanych do odnajdywania
id	integer (int32)	Identyfikator przebiegu testu.
incompleteTests	integer (int32)	Liczba niekompletnych testów.
isAutomated	boolean	wartość true, jeśli przebieg testu jest zautomatyzowany, w przeciwnym razie wartość false.
iteration	string	Iteracji, do której należy przebieg.
lastUpdatedBy	IdentityRef	Identyfikator podstawy zespołu ostatniej aktualizacji przebiegu testu.
lastUpdatedDate	string (date-time)	Data i godzina ostatniej aktualizacji
name	string	Nazwa przebiegu testu.
notApplicableTests	integer (int32)	Liczba nie dotyczy testów.
owner	IdentityRef	Identyfikator team foundation właściciela przebiegów.
passedTests	integer (int32)	Liczba testów zakończonych powodzeniem w przebiegu
phase	string	Faza/stan testuUruchomienie.
pipelineReference	PipelineReference	Odwołanie do potoku, do którego należy ten przebieg testu.
plan	ShallowReference	Plan testu skojarzony z tym przebiegiem testu.
postProcessState	string	Stan po przetworzeniu.
project	ShallowReference	Projekt skojarzony z tym przebiegiem.
release	ReleaseReference	Dokumentacja wydania dla przebiegu testu.
releaseEnvironmentUri	string	Identyfikator URI środowiska wydania dla elementu TestRun.
releaseUri	string	Identyfikator URI wydania dla elementu TestRun.
revision	integer (int32)
runStatistics	RunStatistic[]	PrzebiegSummary według wyniku.
startedDate	string (date-time)	Data rozpoczęcia przebiegu.
state	string	Stan przebiegu. Typ TestRunState Prawidłowe stany — nieokreślony , NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate	TestRunSubstate	Stan podrzędny TestRun.
tags	TestTag[]	Tagi dołączone do tego przebiegu testu.
testEnvironment	TestEnvironment	Środowisko testowe skojarzone z przebiegiem.
testMessageLogId	integer (int32)
testSettings	ShallowReference	Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji z jednolity sposób odwołowania się do innych zasobów w sposób zapewniający łatwy przechodzenie przez łącza.
totalTests	integer (int32)	Łączna liczba testów w przebiegu
unanalyzedTests	integer (int32)	Liczba testów zakończonych niepowodzeniem w przebiegu.
url	string	Adres URL przebiegu testu
webAccessUrl	string	Adres URL dostępu do sieci Web dla elementu TestRun.

TestRunPublishContext

Wyliczanie

Funkcja PublishContext przebiegów do odpytowania.

Wartość	Opis
all	Uruchomienie jest publikowane dla dowolnego kontekstu.
build	Uruchamianie jest publikowane dla kontekstu kompilacji.
release	Uruchomienie jest publikowane dla kontekstu wydania.

TestRunState

Wyliczanie

Wartość	Opis
aborted	Uruchamianie zostało zatrzymane, a pozostałe testy zostały przerwane
completed	Wszystkie testy zostały ukończone lub pominięte.
inProgress	Testy są uruchomione.
needsInvestigation	Uruchomienie wymaga zbadania z powodu błędu punktu testowego. Jest to starszy stan i nie należy go już używać
notStarted	Przebieg jest nadal tworzony. Nie rozpoczęto jeszcze żadnych testów.
unspecified	Używane tylko podczas aktualizacji, aby zachować istniejącą wartość.
waiting	Uruchamianie jest obecnie inicjowane. Jest to stan starszej wersji i nie powinien być już używany

TestRunSubstate

Wyliczanie

Typy stanów podrzędnych dla przebiegu testu.

Wartość	Opis
abortedBySystem	Uruchom stan po przerwaniu przez system.
analyzed	Uruchom stan po przeanalizowaniu.
canceledByUser	Uruchom stan podczas tworzenia środowiska.
cancellationInProgress	Stan uruchomienia, gdy anulowanie jest w toku.
creatingEnvironment	Uruchom stan podczas tworzenia środowiska.
none	Uruchom polecenie bezstanu.
pendingAnalysis	Uruchom stan podczas oczekującej analizy.
runningTests	Uruchom stan podczas uruchamiania testów.
timedOut	Stan uruchomienia po przekroczeniu limitu czasu przebiegu.

TestTag

Objekt

Tag dołączony do przebiegu lub wyniku.

Nazwa	Typ	Opis
name	string	Nazwa tagu, alfanumeryczna wartość mniejsza niż 30 znaków