Runs - Get Test Run By Id

Odwołanie

Usługa:: Test

Wersja interfejsu API:: 7.1

Uzyskaj testowy przebieg według jego identyfikatora.

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

Z parametrami opcjonalnymi:

GET https://dev.azure.com/{organization}/{project}/_apis/test/runs/{runId}?includeDetails={includeDetails}&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
runId	path	True	integer (int32)	Identyfikator przebiegu do pobrania.
api-version	query	True	string	Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API.
includeDetails	query		boolean	Wartość domyślna to true. Zawiera szczegółowe informacje, takie jak statystyki uruchamiania, wydanie, kompilacja, środowisko testowe, stan po procesie i nie tylko.

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.

Przykłady

Przykładowe żądanie

HTTP

GET https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/runs/1?api-version=7.1

Przykładowa odpowiedź

Kod stanu:: 200

{
  "id": 1,
  "name": "sprint1 (Manual)",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Runs/1",
  "isAutomated": false,
  "iteration": "Fabrikam-Fiber-TFVC\\Release 1\\Sprint 1",
  "owner": {
    "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "displayName": "Fabrikam Fiber",
    "uniqueName": "fabrikamfiber1@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
  },
  "project": {
    "id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
    "name": "Fabrikam-Fiber-TFVC",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/Fabrikam-Fiber-TFVC"
  },
  "startedDate": "2014-05-04T12:50:33.17Z",
  "completedDate": "2014-05-04T12:50:31.953Z",
  "state": "Completed",
  "plan": {
    "id": "1",
    "name": "sprint1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
  },
  "postProcessState": "Complete",
  "totalTests": 1,
  "passedTests": 1,
  "createdDate": "2014-05-04T12:50:31.38Z",
  "lastUpdatedDate": "2014-05-04T12:50:31.953Z",
  "lastUpdatedBy": {
    "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "displayName": "Fabrikam Fiber",
    "uniqueName": "fabrikamfiber1@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
  },
  "revision": 3
}

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.
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.

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

Udostępnij za pośrednictwem

Runs - Get Test Run By Id

Parametry identyfikatora URI

Odpowiedzi

Zabezpieczenia

oauth2

Zakresy

Przykłady

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

BuildConfiguration

CustomTestField

DtlEnvironmentDetails

IdentityRef

JobReference

PhaseReference

PipelineReference

ReferenceLinks

ReleaseReference

ResultMetadata

RunFilter

RunStatistic

ShallowReference

StageReference

TestEnvironment

TestResolutionState

TestRun

TestRunSubstate

TestTag

Dodatkowe zasoby