Udostępnij przez

Runs - Query

  • Odwołanie
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.
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