Sdílet prostřednictvím


Runs - Query

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

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ů