Sdílet prostřednictvím


Runs - Create

Vytvořte nový testovací běh.

POST https://dev.azure.com/{organization}/{project}/_apis/test/runs?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.

Text požadavku

Name Typ Description
automated

boolean

true, pokud je testovací běh automatizovaný, jinak false. Ve výchozím nastavení bude false.

build

ShallowReference

Abstraktní odkaz na sestavení, do kterého patří.

buildDropLocation

string

Umístění sestavení použitého k testovacímu běhu

buildFlavor

string

Příchuť sestavení použitého k testovacímu běhu (Např. vydání, ladění)

buildPlatform

string

Platforma sestavení, která se používá k testovacímu běhu (např.: x86, amd64)

buildReference

BuildConfiguration

BuildReference testovacího běhu.

comment

string

Komentáře zadané těmi, kdo analyzují spuštění.

completeDate

string

Datum dokončení spuštění.

configurationIds

integer[]

ID konfigurací testů přidružených ke spuštění.

controller

string

Název testovacího kontroleru používaného pro automatizované spuštění.

customTestFields

CustomTestField[]

Další vlastnosti testovacího běhu

dtlAutEnvironment

ShallowReference

Abstraktní odkaz na DtlAutEnvironment.

dtlTestEnvironment

ShallowReference

Abstraktní odkaz na DtlTestEnvironment.

dueDate

string

Datum a čas splnění pro testovací běh.

environmentDetails

DtlEnvironmentDetails

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

errorMessage

string

Chybová zpráva přidružená ke spuštění.

filter

RunFilter

Filtr používaný ke zjištění spuštění.

iteration

string

Iterace, ve které se má vytvořit spuštění. Kořenová iterace týmového projektu bude výchozí.

name

string

Název testovacího běhu

owner

IdentityRef

Zobrazované jméno vlastníka spuštění

pipelineReference

PipelineReference

Odkaz na kanál, ke kterému patří toto testovací spuštění. PipelineReference.PipelineId by se mělo rovnat RunCreateModel.Build.Id

plan

ShallowReference

Abstraktní odkaz na plán, který patří.

pointIds

integer[]

ID testovacích bodů, které se mají použít v běhu.

releaseEnvironmentUri

string

Identifikátor URI prostředí vydané verze přidruženého ke spuštění.

releaseReference

ReleaseReference

Odkaz na verzi přidruženou k testovacímu běhu

releaseUri

string

Identifikátor URI vydané verze přidružené ke spuštění.

runSummary

RunSummaryModel[]

Souhrn spuštění pro typ spuštění = NoConfigRun.

runTimeout

string

Časový rozsah do vypršení časového limitu.

sourceWorkflow

string

SourceWorkFlow (CI/CD) testovacího běhu.

startDate

string

Počáteční datum a čas spuštění.

state

string

Stav spuštění. Typ TestRunState Platné stavy – NotStarted, InProgress, Waiting

tags

TestTag[]

Značky, které se mají připojit k testovacímu běhu, ke spuštění je možné přidat maximálně 5 značek.

testConfigurationsMapping

string

TestConfigurationMapping testovacího běhu.

testEnvironmentId

string

ID testovacího prostředí přidruženého ke spuštění.

testSettings

ShallowReference

Abstrahovaný odkaz na prostředek nastavení testu.

type

string

Typ platných hodnot run(RunType): (Unspecified, Normal, Blocking, Web, MtrRunInitiatedFromWeb, RunWithDtlEnv, NoConfigRun)

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_write Uděluje možnost číst, vytvářet a aktualizovat testovací plány, případy, výsledky a další artefakty související se správou testů.

Příklady

Sample Request

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

{
  "name": "NewTestRun",
  "plan": {
    "id": "1"
  },
  "pointIds": [
    1,
    1
  ]
}

Sample Response

{
  "id": 31,
  "name": "NewTestRun",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Runs/31",
  "isAutomated": false,
  "iteration": "Fabrikam-Fiber-TFVC\\Release 1\\Sprint 1",
  "owner": {
    "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabrikamfiber3@hotmail.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
  },
  "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-28T16:39:00.44Z",
  "state": "InProgress",
  "plan": {
    "id": "1",
    "name": "sprint1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
  },
  "postProcessState": "Complete",
  "totalTests": 2,
  "incompleteTests": 2,
  "createdDate": "2014-05-28T16:39:00.4Z",
  "lastUpdatedDate": "2014-05-28T16:39:00.44Z",
  "lastUpdatedBy": {
    "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabrikamfiber3@hotmail.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
  },
  "revision": 2
}

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.

RunCreateModel

Podrobnosti o vytvoření testovacího běhu

RunFilter

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

RunStatistic

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

RunSummaryModel

Spusťte souhrn pro každý výstupní typ testu.

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

Příprava kanálu

TestEnvironment

Podrobnosti testovacího prostředí.

TestOutcome
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á 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 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 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

Nechutná metadata

rerun

string

Opětovné spuštění metadat

RunCreateModel

Podrobnosti o vytvoření testovacího běhu

Name Typ Description
automated

boolean

true, pokud je testovací běh automatizovaný, jinak false. Ve výchozím nastavení bude false.

build

ShallowReference

Abstraktní odkaz na sestavení, do kterého patří.

buildDropLocation

string

Umístění sestavení použitého k testovacímu běhu

buildFlavor

string

Příchuť sestavení použitého k testovacímu běhu (Např. vydání, ladění)

buildPlatform

string

Platforma sestavení, která se používá k testovacímu běhu (např.: x86, amd64)

buildReference

BuildConfiguration

BuildReference testovacího běhu.

comment

string

Komentáře zadané těmi, kdo analyzují spuštění.

completeDate

string

Datum dokončení spuštění.

configurationIds

integer[]

ID konfigurací testů přidružených ke spuštění.

controller

string

Název testovacího kontroleru používaného pro automatizované spuštění.

customTestFields

CustomTestField[]

Další vlastnosti testovacího běhu

dtlAutEnvironment

ShallowReference

Abstraktní odkaz na DtlAutEnvironment.

dtlTestEnvironment

ShallowReference

Abstraktní odkaz na DtlTestEnvironment.

dueDate

string

Datum a čas splnění pro testovací běh.

environmentDetails

DtlEnvironmentDetails

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

errorMessage

string

Chybová zpráva přidružená ke spuštění.

filter

RunFilter

Filtr používaný ke zjištění spuštění.

iteration

string

Iterace, ve které se má vytvořit spuštění. Kořenová iterace týmového projektu bude výchozí.

name

string

Název testovacího běhu

owner

IdentityRef

Zobrazované jméno vlastníka spuštění

pipelineReference

PipelineReference

Odkaz na kanál, ke kterému patří toto testovací spuštění. PipelineReference.PipelineId by se mělo rovnat RunCreateModel.Build.Id

plan

ShallowReference

Abstraktní odkaz na plán, který patří.

pointIds

integer[]

ID testovacích bodů, které se mají použít v běhu.

releaseEnvironmentUri

string

Identifikátor URI prostředí vydané verze přidruženého ke spuštění.

releaseReference

ReleaseReference

Odkaz na verzi přidruženou k testovacímu běhu

releaseUri

string

Identifikátor URI vydané verze přidružené ke spuštění.

runSummary

RunSummaryModel[]

Souhrn spuštění pro typ spuštění = NoConfigRun.

runTimeout

string

Časový rozsah do vypršení časového limitu.

sourceWorkflow

string

SourceWorkFlow (CI/CD) testovacího běhu.

startDate

string

Počáteční datum a čas spuštění.

state

string

Stav spuštění. Typ TestRunState Platné stavy – NotStarted, InProgress, Waiting

tags

TestTag[]

Značky, které se mají připojit k testovacímu běhu, ke spuštění je možné přidat maximálně 5 značek.

testConfigurationsMapping

string

TestConfigurationMapping testovacího běhu.

testEnvironmentId

string

ID testovacího prostředí přidruženého ke spuštění.

testSettings

ShallowReference

Abstrahovaný odkaz na prostředek nastavení testu.

type

string

Typ platných hodnot run(RunType): (Unspecified, Normal, Blocking, Web, MtrRunInitiatedFromWeb, RunWithDtlEnv, NoConfigRun)

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

RunSummaryModel

Spusťte souhrn pro každý výstupní typ testu.

Name Typ Description
duration

integer

Celková doba potřebná v milisekundách

resultCount

integer

Počet výsledků pro Result TestOutcome

testOutcome

TestOutcome

Souhrn je založený na 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.

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

TestOutcome

Name Typ Description
aborted

string

Test byl přerušen. Příčinou nebylo gesto uživatele, ale spíše rozhodnutí o architektuře.

blocked

string

Test měl šanci na provedení, ale nebyl, protože ITestElement.IsRunnable == false.

error

string

Při pokusu o provedení testu došlo k systémové chybě.

failed

string

Test se spustil, ale došlo k problémům. Problémy mohou zahrnovat výjimky nebo neúspěšné kontrolní výrazy.

inProgress

string

Právě probíhá test. Přidání pro grafy TCM

inconclusive

string

Test se dokončil, ale nemůžeme říct, jestli byl úspěšný nebo neúspěšný. Může se použít pro přerušené testy...

none

string

Test nebyl dokončen nebo typ testu nehlásí úspěšné nebo neúspěšné testy.

notApplicable

string

Test nelze použít pro spuštění.

notExecuted

string

Test nebyl proveden. Příčinou bylo gesto uživatele – například tlačítko Zastavit.

notImpacted

string

Na test to nemá vliv. Přidání fot TIA.

passed

string

Test byl proveden bez jakýchkoli problémů.

paused

string

Test je pozastavený.

timeout

string

Časový limit testu vypršel.

unspecified

string

Používá se pouze během aktualizace k zachování existující hodnoty.

warning

string

Použije se ve výsledcích na úrovni spuštění. Nejedná se o selhání.

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í 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 – 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á k běhu nebo výsledku

Name Typ Description
name

string

Název značky, alfanumerická hodnota menší než 30 znaků