Runs - Query

Service:

Test

API Version:

7.1-preview.3

Dotazování testovacích běhů na základě filtrů Povinná pole jsou minLastUpdatedDate a 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 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
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.
maxLastUpdatedDate	query	True	string date-time	Maximální datum poslední změny pro dotazování (povinné, rozdíl mezi minimálním a maximálním datem může být maximálně 7 dnů).
minLastUpdatedDate	query	True	string date-time	Minimální datum poslední změny spuštění, které se má dotazovat (povinné).
$top	query		integer int32	Počet spuštění, která se mají dotazovat. Limit je 100
branchName	query		string	Název zdrojové větve spuštění, která se mají dotazovat.
buildDefIds	query		string array (int32)	Id definice sestavení spuštění, která se mají dotazovat, seznam platných ID oddělených čárkami (počet id limitu 10).
buildIds	query		string array (int32)	ID sestavení spuštění, která se mají dotazovat, seznam platných ID oddělených čárkami (počet id limitu 10).
continuationToken	query		string	continuationToken přijatý z předchozí dávky nebo null pro první dávku. Uživatel by ho neměl vytvářet (ani měnit, pokud byl přijat z poslední dávky).
isAutomated	query		boolean	Typ automatizace spuštění, která se mají dotazovat.
planIds	query		string array (int32)	ID plánu spuštění, která se mají dotazovat, seznam platných ID oddělených čárkami (počet id limitu 10).
publishContext	query		TestRunPublishContext	PublishContext spuštění, která se mají dotazovat.
releaseDefIds	query		string array (int32)	ID definice verze spuštění, která se mají dotazovat, seznam platných ID oddělených čárkami (počet id limitu 10).
releaseEnvDefIds	query		string array (int32)	ID definice prostředí verze pro dotazovaná spuštění oddělená čárkami (číslo limitu id 10).
releaseEnvIds	query		string array (int32)	ID prostředí verze pro spuštění, která se mají dotazovat, seznam platných ID oddělených čárkami (číslo limitu id 10).
releaseIds	query		string array (int32)	ID verze spuštění, která se mají dotazovat, seznam platných ID oddělených čárkami (číslo limitu id 10).
runTitle	query		string	Název spuštění spuštění, která se mají dotazovat.
state	query		TestRunState	Aktuální stav spuštění, která se mají dotazovat.

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	Umožňuje číst testovací plány, případy, výsledky a další artefakty související se správou testů.

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 testovacím prostředí.
IdentityRef
JobReference	Úloha v kanálu. To souvisí s maticí v YAML.
PhaseReference	Fáze v kanálu
PipelineReference	Referenční informace 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 se používá k poskytování filtrů používaných pro zjišťování.
RunStatistic	Statistika testovacího běhu podle výsledku
ShallowReference	Abstrahovaný odkaz na nějaký jiný prostředek. Tato třída se používá k poskytování kontraktů dat sestavení s jednotným způsobem, jak odkazovat na jiné prostředky způsobem, který umožňuje snadno procházet odkazy.
StageReference	Fáze v kanálu
TestEnvironment	Podrobnosti testovacího prostředí.
TestResolutionState	Podrobnosti o stavu řešení testů
TestRun	Podrobnosti o testovacím běhu
TestRunPublishContext	PublishContext spuštění, která se mají dotazovat.
TestRunState
TestRunSubstate	Typy dílčích stavů pro testovací běh.
TestTag	Značka připojená k běhu nebo výsledku

BuildConfiguration

Podrobnosti o buildConfiguration.

Name	Typ	Description
branchName	string	Název větve, pro kterou se build vygeneruje.
buildDefinitionId	integer	BuildDefinitionId pro sestavení.
buildSystem	string	Sestavení systému.
creationDate	string	Datum vytvoření sestavení.
flavor	string	Varianta sestavení (např. Sestavení/vydání).
id	integer	ID buildconfiguration.
number	string	Číslo sestavení.
platform	string	BuildConfiguration Platform.
project	ShallowReference	Projekt přidružený k této konfiguraci sestavení.
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 testovacím prostředí.

Name	Typ	Description
csmContent	string
csmParameters	string
subscriptionName	string

IdentityRef

Name	Typ	Description
_links	ReferenceLinks	Toto pole obsahuje nula nebo více zajímavých odkazů o předmětu 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 napříč účty i organizacemi.
directoryAlias	string	Zastaralé – lze načíst dotazem uživatele Graphu, na který odkazuje položka "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é – lze načíst dotazem na stav členství graphu, na který odkazuje položka membershipState slovníku GraphUser "_links".
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ě existujících implementací ToIdentityRef
uniqueName	string	Zastaralé – místo toho použijte Domain+PrincipalName.
url	string	Tato adresa URL je úplná trasa 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í informace 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 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 verze
environmentCreationDate	string	Datum vytvoření prostředí (UTC)
environmentDefinitionId	integer	ID definice prostředí verze
environmentDefinitionName	string	Název definice prostředí verze
environmentId	integer	ID prostředí verze
environmentName	string	Název prostředí verze.
id	integer	ID verze.
name	string	Název verze

ResultMetadata

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

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

RunFilter

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

Name	Typ	Description
sourceFilter	string	filtrování zdrojů testovacích případů (testovací kontejnery)
testCaseFilter	string	filtr pro testovací případy

RunStatistic

Statistika testovacího běhu 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 spuštění.
resultMetadata	ResultMetadata	ResultMetadata pro daný výsledek/počet.
state	string	Stav testovacího běhu

ShallowReference

Abstrahovaný odkaz na nějaký jiný prostředek. Tato třída se používá k poskytování kontraktů dat sestavení s jednotným způsobem, jak odkazovat na jiné prostředky způsobem, který umožňuje snadno procházet odkazy.

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

Fáze v 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í testů

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

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í a čas spuštění.
controller	string	Test Run Controller.
createdDate	string	Datum vytvoření testovacího spuštění.
customFields	CustomTestField[]	Seznam vlastních polí pro TestRun
dropLocation	string	Umístění pro testovací spuštění
dtlAutEnvironment	ShallowReference	Abstrahovaný odkaz na nějaký jiný prostředek. Tato třída se používá k poskytování kontraktů dat sestavení s jednotným způsobem, jak odkazovat na jiné prostředky způsobem, který umožňuje snadno procházet odkazy.
dtlEnvironment	ShallowReference	Abstrahovaný odkaz na nějaký jiný prostředek. Tato třída se používá k poskytování kontraktů dat sestavení s jednotným způsobem, jak odkazovat na jiné prostředky způsobem, který umožňuje snadno procházet odkazy.
dtlEnvironmentCreationDetails	DtlEnvironmentDetails	Toto je dočasná třída, která poskytuje podrobnosti o testovacím prostředí.
dueDate	string	Datum a čas splnění testovacího běhu.
errorMessage	string	Chybová zpráva přidružená k běhu
filter	RunFilter	Tato třída se používá k poskytování filtrů používaných pro 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ý, v opačném případě false.
iteration	string	Iterace, do 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, do kterého patří toto testovací spuštění.
plan	ShallowReference	Testovací plán přidružený k tomuto testovacímu běhu.
postProcessState	string	Stav procesu po dokončení.
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í 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 – nespecifikované, Nezahájené, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate	TestRunSubstate	TestRun Substate.
tags	TestTag[]	Značky připojené k tomuto testovacímu běhu
testEnvironment	TestEnvironment	Testovací prostředí přidružené k běhu
testMessageLogId	integer
testSettings	ShallowReference	Abstrahovaný odkaz na nějaký jiný prostředek. Tato třída se používá k poskytování kontraktů dat sestavení s jednotným způsobem, jak odkazovat na jiné prostředky způsobem, který umožňuje snadno procházet odkazy.
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.

TestRunPublishContext

PublishContext spuštění, která se mají dotazovat.

Name	Typ	Description
all	string	Spuštění se publikuje pro libovolný kontext.
build	string	Spuštění se publikuje pro kontext sestavení.
release	string	Spuštění se publikuje pro kontext vydané verze.

TestRunState

Name	Typ	Description
aborted	string	Spuštění je zastaveno a zbývající testy byly přerušeny.
completed	string	Všechny testy byly dokončeny nebo vynechány.
inProgress	string	Testy jsou spuštěné.
needsInvestigation	string	Spuštění vyžaduje šetření kvůli selhání testovacího bodu. Jedná se o starší verzi a nemělo by se už používat.
notStarted	string	Spuštění se stále vytváří. Zatím nebyly zahájeny žádné testy.
unspecified	string	Používá se pouze během aktualizace k zachování existující hodnoty.
waiting	string	Spuštění se aktuálně inicializuje: Jedná se o starší verzi a už by se nemělo používat.

TestRunSubstate

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

Name	Typ	Description
abortedBySystem	string	Spuštění stavu, když je přerušeno systémem.
analyzed	string	Stav spuštění po analýze
canceledByUser	string	Při vytváření prostředí spusťte stav.
cancellationInProgress	string	Stav spuštění, když probíhá zrušení.
creatingEnvironment	string	Při vytváření prostředí spusťte stav.
none	string	Spusťte příkaz noState.
pendingAnalysis	string	Během čekající analýzy spusťte stav.
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á k běhu nebo výsledku

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