Runs - Get Test Run By Id

Reference

Service:: Test

API Version:: 7.1-preview.3

Získejte testovací běh podle jeho ID.

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

With optional parameters:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
organization	path	True	string	Název organizace Azure DevOps.
project	path	True	string	ID projektu nebo název projektu
runId	path	True	integer int32	ID spuštění, které chcete získat.
api-version	query	True	string	Verze rozhraní API, která se má použít. Aby se tato verze rozhraní API používala, měla by být nastavená na 7.1-preview.3.
includeDetails	query		boolean	Výchozí hodnota je true (pravda). Obsahuje podrobnosti, jako je statistika spuštění, vydání, sestavení, testovací prostředí, stav po procesu a další.

Odpovědi

Name	Typ	Description
200 OK	TestRun	úspěšná operace

Zabezpečení

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

Name	Description
vso.test	Uděluje možnost číst testovací plány, případy, výsledky a další artefakty související se správou testů.

Příklady

Sample Request

HTTP

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

Sample Response

Status code:: 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
}

Definice

Name	Description
BuildConfiguration	Podrobnosti o buildConfiguration.
CustomTestField	Informace o vlastním poli. Povolený klíč: Páry hodnot – ( AttemptId: int value, IsTestResultFlaky: bool)
DtlEnvironmentDetails	Toto je dočasná třída, která poskytuje podrobnosti o prostředí testovacího běhu.
IdentityRef
JobReference	Úloha v kanálu To souvisí s maticí v YAML.
PhaseReference	Fáze v kanálu
PipelineReference	Referenční dokumentace ke kanálu
ReferenceLinks	Třída představující kolekci odkazů REST.
ReleaseReference	Odkaz na verzi
ResultMetadata	ResultMetadata pro daný výsledek/počet.
RunFilter	Tato třída slouží k poskytování filtrů používaných ke zjišťování.
RunStatistic	Statistika testovacích běhů podle výsledku
ShallowReference	Abstraktní odkaz na nějaký jiný prostředek. Tato třída se používá k poskytování kontraktů dat sestavení s jednotným způsobem odkazování na jiné prostředky způsobem, který umožňuje snadné procházení prostřednictvím odkazů.
StageReference	Příprava kanálu
TestEnvironment	Podrobnosti testovacího prostředí.
TestResolutionState	Podrobnosti o stavu řešení testu
TestRun	Podrobnosti o testovacím běhu
TestRunSubstate	Typy dílčích stavů pro testovací běh.
TestTag	Značka připojená ke spuštění nebo výsledku.

BuildConfiguration

Podrobnosti o buildConfiguration.

Name	Typ	Description
branchName	string	Název větve, pro kterou se vygeneruje sestavení.
buildDefinitionId	integer	BuildDefinitionId pro sestavení.
buildSystem	string	Sestavit systém.
creationDate	string	Datum vytvoření sestavení.
flavor	string	Varianta sestavení (např. Sestavení/vydání).
id	integer	BuildConfiguration Id.
number	string	Číslo buildu.
platform	string	BuildConfiguration Platform.
project	ShallowReference	Projekt přidružený k tomuto BuildConfiguration.
repositoryGuid	string	Identifikátor GUID úložiště pro sestavení
repositoryType	string	Typ úložiště (např. TFSGit).
sourceVersion	string	Aktivovala se zdrojová verze (/první potvrzení) sestavení.
targetBranchName	string	Target BranchName.
uri	string	Identifikátor URI sestavení

CustomTestField

Informace o vlastním poli. Povolený klíč: Páry hodnot – ( AttemptId: int value, IsTestResultFlaky: bool)

Name	Typ	Description
fieldName	string	Název pole
value	object	Hodnota pole.

DtlEnvironmentDetails

Toto je dočasná třída, která poskytuje podrobnosti o prostředí testovacího běhu.

Name	Typ	Description
csmContent	string
csmParameters	string
subscriptionName	string

IdentityRef

Name	Typ	Description
_links	ReferenceLinks	Toto pole neobsahuje žádný nebo více zajímavých odkazů na téma grafu. Tyto odkazy mohou být vyvolány za účelem získání dalších relací nebo podrobnějších informací o tomto předmětu grafu.
descriptor	string	Popisovač je primárním způsobem, jak odkazovat na předmět grafu, když je systém spuštěný. Toto pole jednoznačně identifikuje stejný předmět grafu v rámci účtů i organizací.
directoryAlias	string	Zastaralé – Dá se načíst dotazem na uživatele Graphu odkazovaného v položce "self" slovníku IdentityRef "_links"
displayName	string	Toto je jedinečný zobrazovaný název předmětu grafu. Pokud chcete toto pole změnit, musíte změnit jeho hodnotu ve zdrojovém poskytovateli.
id	string
imageUrl	string	Zastaralé – k dispozici v položce "avatar" ve slovníku IdentityRef "_links"
inactive	boolean	Zastaralé – Můžete ho načíst dotazem na stav členství v Graphu, na který odkazuje položka membershipState slovníku _links GraphUser.
isAadIdentity	boolean	Zastaralé – lze odvodit z typu předmětu popisovače (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Zastaralé – Lze odvodit z typu předmětu popisovače (Descriptor.IsGroupType).
isDeletedInOrigin	boolean
profileUrl	string	Zastaralé – nepoužívá se ve většině dříve existujících implementací ToIdentityRef
uniqueName	string	Zastaralé – místo toho použijte Domain+PrincipalName.
url	string	Tato adresa URL představuje úplnou trasu ke zdrojovému prostředku tohoto předmětu grafu.

JobReference

Úloha v kanálu To souvisí s maticí v YAML.

Name	Typ	Description
attempt	integer	Číslo pokusu o úlohu
jobName	string	Matice v YAML generuje kopie úlohy s různými vstupy v matici. JobName je název tohoto vstupu. Maximální podporovaná délka názvu je 256 znaků.

PhaseReference

Fáze v kanálu

Name	Typ	Description
attempt	integer	Číslo pokusu fáze
phaseName	string	Název fáze. Maximální podporovaná délka názvu je 256 znaků.

PipelineReference

Referenční dokumentace ke kanálu

Name	Typ	Description
jobReference	JobReference	Odkaz na úlohu
phaseReference	PhaseReference	Odkaz na fázi.
pipelineId	integer	Odkaz na kanál, se kterým tato instance kanálu souvisí.
stageReference	StageReference	Odkaz na fázi.

ReferenceLinks

Třída představující kolekci odkazů REST.

Name	Typ	Description
links	object	Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako odkazy jen pro čtení.

ReleaseReference

Odkaz na verzi

Name	Typ	Description
attempt	integer	Počet pokusů o vydání
creationDate	string	Datum vytvoření verze (UTC)
definitionId	integer	ID definice vydané verze.
environmentCreationDate	string	Datum vytvoření prostředí (UTC)
environmentDefinitionId	integer	ID definice prostředí verze
environmentDefinitionName	string	Název definice prostředí vydané verze
environmentId	integer	ID prostředí verze.
environmentName	string	Název prostředí vydané verze.
id	integer	ID vydané verze.
name	string	Název verze

ResultMetadata

ResultMetadata pro daný výsledek/počet.

Name	Typ	Description
flaky	string	Nechutná metadata
rerun	string	Opětovné spuštění metadat

RunFilter

Tato třída slouží k poskytování filtrů používaných ke zjišťování.

Name	Typ	Description
sourceFilter	string	filtr pro zdroje testovacích případů (testovací kontejnery)
testCaseFilter	string	filtr pro testovací případy

RunStatistic

Statistika testovacích běhů podle výsledku

Name	Typ	Description
count	integer	Počet výsledků testu pro daný výsledek.
outcome	string	Výsledek testu
resolutionState	TestResolutionState	Stav řešení testovacího běhu
resultMetadata	ResultMetadata	ResultMetadata pro daný výsledek/počet.
state	string	Stav testovacího běhu

ShallowReference

Abstraktní odkaz na nějaký jiný prostředek. Tato třída se používá k poskytování kontraktů dat sestavení s jednotným způsobem odkazování na jiné prostředky způsobem, který umožňuje snadné procházení prostřednictvím odkazů.

Name	Typ	Description
id	string	ID prostředku
name	string	Název propojeného prostředku (název definice, název kontroleru atd.)
url	string	Úplný odkaz HTTP na prostředek

StageReference

Příprava kanálu

Name	Typ	Description
attempt	integer	Počet pokusů o fázi
stageName	string	Název fáze Maximální podporovaná délka názvu je 256 znaků.

TestEnvironment

Podrobnosti testovacího prostředí.

Name	Typ	Description
environmentId	string	ID testovacího prostředí
environmentName	string	Název testovacího prostředí.

TestResolutionState

Podrobnosti o stavu řešení testu

Name	Typ	Description
id	integer	ID stavu řešení testu
name	string	Název stavu řešení testu.
project	ShallowReference	Abstraktní odkaz na nějaký jiný prostředek. Tato třída se používá k poskytování kontraktů dat sestavení s jednotným způsobem odkazování na jiné prostředky způsobem, který umožňuje snadné procházení prostřednictvím odkazů.

TestRun

Podrobnosti o testovacím běhu

Name	Typ	Description
build	ShallowReference	Sestavení přidružené k tomuto testovacímu běhu
buildConfiguration	BuildConfiguration	Podrobnosti o konfiguraci sestavení přidružené k tomuto testovacímu běhu
comment	string	Komentáře zadané těmi, kdo analyzují spuštění.
completedDate	string	Datum dokončení spuštění.
controller	string	Test Run Controller.
createdDate	string	Datum vytvoření testovacího běhu.
customFields	CustomTestField[]	Seznam vlastních polí pro TestRun.
dropLocation	string	Umístění testovacího běhu.
dtlAutEnvironment	ShallowReference	Abstraktní odkaz na nějaký jiný prostředek. Tato třída se používá k poskytování kontraktů dat sestavení s jednotným způsobem odkazování na jiné prostředky způsobem, který umožňuje snadné procházení prostřednictvím odkazů.
dtlEnvironment	ShallowReference	Abstraktní odkaz na nějaký jiný prostředek. Tato třída se používá k poskytování kontraktů dat sestavení s jednotným způsobem odkazování na jiné prostředky způsobem, který umožňuje snadné procházení prostřednictvím odkazů.
dtlEnvironmentCreationDetails	DtlEnvironmentDetails	Toto je dočasná třída, která poskytuje podrobnosti o prostředí testovacího běhu.
dueDate	string	Datum a čas splnění pro testovací běh.
errorMessage	string	Chybová zpráva přidružená ke spuštění.
filter	RunFilter	Tato třída slouží k poskytování filtrů používaných ke zjišťování.
id	integer	ID testovacího běhu
incompleteTests	integer	Počet neúplných testů
isAutomated	boolean	true, pokud je testovací běh automatizovaný, jinak false.
iteration	string	Iterace, ke které patří spuštění.
lastUpdatedBy	IdentityRef	ID základu týmu poslední aktualizace testovacího běhu.
lastUpdatedDate	string	Datum a čas poslední aktualizace
name	string	Název testovacího běhu
notApplicableTests	integer	Počet testů, které nelze použít
owner	IdentityRef	TEAM Foundation ID vlastníka spuštění.
passedTests	integer	Počet úspěšných testů v běhu
phase	string	Fáze/stav testovacího spuštění.
pipelineReference	PipelineReference	Odkaz na kanál, ke kterému patří toto testovací spuštění.
plan	ShallowReference	Testovací plán přidružený k tomuto testovacímu běhu.
postProcessState	string	Stav následného zpracování.
project	ShallowReference	Projekt přidružený k tomuto spuštění.
release	ReleaseReference	Referenční informace k verzi testovacího běhu
releaseEnvironmentUri	string	Identifikátor URI prostředí vydané verze pro TestRun.
releaseUri	string	Identifikátor URI verze pro TestRun
revision	integer
runStatistics	RunStatistic[]	RunSummary podle výsledku.
startedDate	string	Počáteční datum a čas spuštění.
state	string	Stav spuštění. Typ TestRunState Platné stavy – neurčené, NotStarted, Probíhající, Dokončeno, Čekání, Přerušeno, NeedsInvestigation
substate	TestRunSubstate	Dílčí stav TestRun.
tags	TestTag[]	Značky připojené k tomuto testovacímu běhu
testEnvironment	TestEnvironment	Testovací prostředí přidružené ke spuštění.
testMessageLogId	integer
testSettings	ShallowReference	Abstraktní odkaz na nějaký jiný prostředek. Tato třída se používá k poskytování kontraktů dat sestavení s jednotným způsobem odkazování na jiné prostředky způsobem, který umožňuje snadné procházení prostřednictvím odkazů.
totalTests	integer	Celkový počet testů v běhu
unanalyzedTests	integer	Počet neúspěšných testů v běhu
url	string	Adresa URL testovacího běhu
webAccessUrl	string	Adresa URL webového přístupu pro TestRun.

TestRunSubstate

Typy dílčích stavů pro testovací běh.

Name	Typ	Description
abortedBySystem	string	Stav spuštění, když je přerušeno systémem.
analyzed	string	Stav spuštění po analýze.
canceledByUser	string	Stav spuštění při vytváření prostředí
cancellationInProgress	string	Stav spuštění, když probíhá rušení.
creatingEnvironment	string	Stav spuštění při vytváření prostředí
none	string	Spusťte příkaz noState.
pendingAnalysis	string	Stav spuštění při čekání na analýzu
runningTests	string	Stav spuštění při spouštění testů
timedOut	string	Stav spuštění při vypršení časového limitu spuštění

TestTag

Značka připojená ke spuštění nebo výsledku.

Name	Typ	Description
name	string	Název značky, alfanumerická hodnota menší než 30 znaků

Sdílet prostřednictvím