Runs - Query

Service:

Test

API Version:

7.1-preview.3

Przebiegi testów zapytań oparte na filtrach. 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-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

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. Powinno to być ustawione na wartość "7.1-preview.3", 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 którego ma być wykonywane zapytanie (obowiązkowe).
$top	query		integer int32	Liczba przebiegów do odpytowania. Limit wynosi 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 (limit nr 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 należy go tworzyć (lub zmieniać, jeśli otrzymano 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 zapytania, rozdzielane przecinkami listę prawidłowych identyfikatorów (limit nr identyfikatorów 10).
publishContext	query		TestRunPublishContext	Funkcja PublishContext przebiegów do odpytowania.
releaseDefIds	query		string array (int32)	Identyfikatory definicji wydania przebiegów do zapytania, rozdzielona przecinkami lista prawidłowych identyfikatorów (limit nr identyfikatorów 10).
releaseEnvDefIds	query		string array (int32)	Identyfikatory definicji środowiska wydania przebiegów do zapytania, rozdzielone przecinkami listę prawidłowych identyfikatorów (limit nr identyfikatorów 10).
releaseEnvIds	query		string array (int32)	Identyfikatory środowiska wydania przebiegów do zapytania, rozdzielona przecinkami lista prawidłowych identyfikatorów (limit nr identyfikatorów 10).
releaseIds	query		string array (int32)	Identyfikatory wydania przebiegów do zapytania, rozdzielona przecinkami lista prawidłowych identyfikatorów (limit nr identyfikatorów 10).
runTitle	query		string	Uruchom tytuł przebiegów do wykonywania zapytań.
state	query		TestRunState	Bieżący stan przebiegów do odpytowania.

Odpowiedzi

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

Zabezpieczenia

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

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: int value, IsTestResultFlaky: bool)
DtlEnvironmentDetails	Jest to klasa tymczasowa, która udostępnia szczegóły ś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 udostępniania 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 w jednolity sposób odwoływanie się do innych zasobów w sposób, który zapewnia łatwe przechodzenie za pośrednictwem linków.
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 na potrzeby przebiegu testu.
TestTag	Tag dołączony do przebiegu lub wyniku.

BuildConfiguration

Szczegóły konfiguracji kompilacji.

Nazwa	Typ	Opis
branchName	string	Nazwa gałęzi, dla której jest generowana kompilacja.
buildDefinitionId	integer	BuildDefinitionId dla kompilacji.
buildSystem	string	System kompilacji.
creationDate	string	Data utworzenia kompilacji.
flavor	string	Smak kompilacji (np. kompilacja/wydanie).
id	integer	Identyfikator kompilacjiKonfiguracja.
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

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

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

DtlEnvironmentDetails

Jest to klasa tymczasowa, która udostępnia szczegóły środowiska uruchomieniowego testu.

Nazwa	Typ	Opis
csmContent	string
csmParameters	string
subscriptionName	string

IdentityRef

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ływanie 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 je 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 tematu 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 Domain+PrincipalName
url	string	Ten adres URL jest pełną trasą do zasobu źródłowego tego tematu grafu.

JobReference

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

Nazwa	Typ	Opis
attempt	integer	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

Faza w potoku

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

PipelineReference

Dokumentacja potoku

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

ReferenceLinks

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

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

ReleaseReference

Odwołanie do wydania.

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

ResultMetadata

ResultMetadata dla danego wyniku/liczby.

Nazwa	Typ	Opis
flaky	string	Flaky metadata (Flaky metadata)
rerun	string	Ponowne uruchamianie metadanych

RunFilter

Ta klasa służy do udostępniania 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

Statystyki przebiegu testu na wynik.

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

ShallowReference

Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji w jednolity sposób odwoływanie się do innych zasobów w sposób, który zapewnia łatwe przechodzenie za pośrednictwem linków.

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

Etap w potoku

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

TestEnvironment

Szczegóły środowiska testowego.

Nazwa	Typ	Opis
environmentId	string	Identyfikator środowiska testowego.
environmentName	string	Nazwa środowiska testowego.

TestResolutionState

Szczegóły stanu rozwiązania testu.

Nazwa	Typ	Opis
id	integer	Identyfikator stanu rozwiązania testu.
name	string	Nazwa stanu rozwiązania testowego.
project	ShallowReference	Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji z jednolitym sposobem odwołowania się do innych zasobów w sposób, który zapewnia łatwy przechodzenie za pośrednictwem linków.

TestRun

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	Ukończono datę i godzinę uruchomienia.
controller	string	Kontroler przebiegu testu.
createdDate	string	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 w jednolity sposób odwoływanie się do innych zasobów w sposób, który zapewnia łatwe przechodzenie za pośrednictwem linków.
dtlEnvironment	ShallowReference	Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji w jednolity sposób odwoływanie się do innych zasobów w sposób, który zapewnia łatwe przechodzenie za pośrednictwem linków.
dtlEnvironmentCreationDetails	DtlEnvironmentDetails	Jest to klasa tymczasowa, która udostępnia szczegóły środowiska uruchomieniowego testu.
dueDate	string	Data i godzina ukończenia przebiegu testu.
errorMessage	string	Komunikat o błędzie skojarzony z przebiegiem.
filter	RunFilter	Ta klasa służy do udostępniania filtrów używanych do odnajdywania
id	integer	Identyfikator przebiegu testu.
incompleteTests	integer	Liczba niekompletnych testów.
isAutomated	boolean	True, jeśli przebieg testu jest zautomatyzowany, w przeciwnym razie wartość false.
iteration	string	Iteracja, do której należy przebieg.
lastUpdatedBy	IdentityRef	Identyfikator podstawy zespołu ostatniej aktualizacji przebiegu testu.
lastUpdatedDate	string	Data i godzina ostatniej aktualizacji
name	string	Nazwa przebiegu testu.
notApplicableTests	integer	Liczba nie dotyczy testów.
owner	IdentityRef	Team Foundation ID właściciela przebiegów.
passedTests	integer	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 testowego.
releaseEnvironmentUri	string	Identyfikator URI środowiska wydania dla elementu TestRun.
releaseUri	string	Identyfikator URI wydania dla elementu TestRun.
revision	integer
runStatistics	RunStatistic[]	RunSummary według wyniku.
startedDate	string	Data rozpoczęcia przebiegu.
state	string	Stan przebiegu. Typ TestRunState Prawidłowe stany — nieokreślone , 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
testSettings	ShallowReference	Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji w jednolity sposób odwoływanie się do innych zasobów w sposób, który zapewnia łatwe przechodzenie za pośrednictwem linków.
totalTests	integer	Łączna liczba testów w przebiegu
unanalyzedTests	integer	Liczba testów zakończonych niepowodzeniem w przebiegu.
url	string	Adres URL przebiegu testowego
webAccessUrl	string	Adres URL dostępu do sieci Web dla testuUruchomienie.

TestRunPublishContext

Funkcja PublishContext przebiegów do odpytowania.

Nazwa	Typ	Opis
all	string	Uruchomienie jest publikowane dla dowolnego kontekstu.
build	string	Uruchomienie jest publikowane dla kontekstu kompilacji.
release	string	Uruchomienie jest publikowane dla kontekstu wydania.

TestRunState

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

TestRunSubstate

Typy stanów podrzędnych na potrzeby przebiegu testu.

Nazwa	Typ	Opis
abortedBySystem	string	Uruchom stan po przerwaniu przez system.
analyzed	string	Uruchom stan po przeanalizowaniu.
canceledByUser	string	Uruchom stan podczas tworzenia środowiska.
cancellationInProgress	string	Uruchom stan, gdy anulowanie jest w toku.
creatingEnvironment	string	Uruchom stan podczas tworzenia środowiska.
none	string	Uruchom polecenie noState.
pendingAnalysis	string	Uruchom stan podczas oczekującej analizy.
runningTests	string	Uruchom stan podczas uruchamiania testów.
timedOut	string	Uruchom stan, gdy przebieg ma limit czasu.

TestTag

Tag dołączony do przebiegu lub wyniku.

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