Condividi tramite

Runs - Get Test Run By Id

  • Riferimento
Service:
Test
API Version:
7.1-preview.3

Ottenere un test eseguito dall'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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
organization
 path True

string

Nome dell'organizzazione di Azure DevOps.
project
 path True

string

ID progetto o nome progetto
runId
 path True

integer

int32

ID dell'esecuzione da ottenere.
api-version
 query True

string

Versione dell'API da usare. Questa opzione deve essere impostata su '7.1-preview.3' per usare questa versione dell'API.
includeDetails
 query

boolean

Il valore predefinito è true. Include dettagli come le statistiche di esecuzione, il rilascio, la compilazione, l'ambiente di test, lo stato post-processo e altro ancora.

Risposte

Nome Tipo Descrizione
200 OK

TestRun

operazione riuscita

Sicurezza

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

Nome Descrizione
vso.test Concede la possibilità di leggere piani di test, case, risultati e altri artefatti correlati alla gestione dei test.

Esempio

Sample Request

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
}

Definizioni

Nome Descrizione
BuildConfiguration

Dettagli di BuildConfiguration.
CustomTestField

Informazioni sul campo personalizzate. Chiave consentita: coppie valore - ( AttemptId: valore int, IsTestResultFlaky: bool)
DtlEnvironmentDetails

Si tratta di una classe temporanea per fornire i dettagli per l'ambiente di esecuzione del test.
IdentityRef
JobReference

Processo nella pipeline. Ciò è correlato alla matrice in YAML.
PhaseReference

Fase nella pipeline
PipelineReference

Riferimento alla pipeline
ReferenceLinks

Classe da rappresentare una raccolta di collegamenti di riferimento REST.
ReleaseReference

Riferimento a una versione.
ResultMetadata

ResultMetadata per il risultato/conteggio specificato.
RunFilter

Questa classe viene usata per fornire i filtri usati per l'individuazione
RunStatistic

Testare le statistiche di esecuzione per risultato.
ShallowReference

Riferimento astratto ad altre risorse. Questa classe viene usata per fornire ai contratti dati di compilazione un modo uniforme per fare riferimento ad altre risorse in modo che fornisca un facile attraversamento attraverso i collegamenti.
StageReference

Fase della pipeline
TestEnvironment

Dettagli dell'ambiente di test.
TestResolutionState

Dettagli sullo stato della risoluzione dei test.
TestRun

Dettagli dell'esecuzione dei test.
TestRunSubstate

Tipi di stati secondari per l'esecuzione di test.
TestTag

Tag collegato a un'esecuzione o a un risultato.

BuildConfiguration

Dettagli di BuildConfiguration.

Nome Tipo Descrizione
branchName

string

Nome del ramo per cui viene generata la compilazione.
buildDefinitionId

integer

BuildDefinitionId per la compilazione.
buildSystem

string

Compilare il sistema.
creationDate

string

Data di creazione della compilazione.
flavor

string

Sapore di compilazione (ad esempio Build/Release).
id

integer

ID buildConfiguration.
number

string

Numero di build.
platform

string

BuildConfiguration Platform.
project

ShallowReference

Progetto associato a questa BuildConfiguration.
repositoryGuid

string

Guid del repository per la compilazione.
repositoryType

string

Tipo di repository (ad esempio. TFSGit).
sourceVersion

string

Versione di origine(/primo commit) per la compilazione è stata attivata.
targetBranchName

string

Nome branch di destinazione.
uri

string

Uri di compilazione.

CustomTestField

Informazioni sul campo personalizzate. Chiave consentita: coppie valore - ( AttemptId: valore int, IsTestResultFlaky: bool)

Nome Tipo Descrizione
fieldName

string

Nome campo.
value

object

Valore del campo.

DtlEnvironmentDetails

Si tratta di una classe temporanea per fornire i dettagli per l'ambiente di esecuzione del test.

Nome Tipo Descrizione
csmContent

string

csmParameters

string

subscriptionName

string

IdentityRef

Nome Tipo Descrizione
_links

ReferenceLinks

Questo campo contiene zero o più collegamenti interessanti sull'oggetto grafico. Questi collegamenti possono essere richiamati per ottenere relazioni aggiuntive o informazioni più dettagliate su questo argomento grafico.
descriptor

string

Il descrittore è il modo principale per fare riferimento all'oggetto del grafico durante l'esecuzione del sistema. Questo campo identificherà in modo univoco lo stesso soggetto grafo in account e organizzazioni.
directoryAlias

string

Deprecato: può essere recuperato eseguendo query sull'utente Graph a cui si fa riferimento nella voce "self" del dizionario IdentityRef "_links"
displayName

string

Si tratta del nome visualizzato non univoco dell'oggetto grafico. Per modificare questo campo, è necessario modificarlo nel provider di origine.
id

string

imageUrl

string

Deprecato - Disponibile nella voce "avatar" del dizionario IdentityRef "_links"
inactive

boolean

Deprecato: può essere recuperato eseguendo una query sullo stato di appartenenza Graph a cui fa riferimento nella voce "membershipState" del dizionario GraphUser "_links"
isAadIdentity

boolean

Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descrittore.IsAadUserType/Descriptor.IsAadGroupType)
isContainer

boolean

Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsGroupType)
isDeletedInOrigin

boolean

profileUrl

string

Deprecato : non in uso nella maggior parte delle implementazioni preesistenti di ToIdentityRef
uniqueName

string

Deprecato: usare invece Domain+PrincipalName
url

string

Questo URL è la route completa alla risorsa di origine di questo oggetto grafico.

JobReference

Processo nella pipeline. Ciò è correlato alla matrice in YAML.

Nome Tipo Descrizione
attempt

integer

Numero di tentativi del processo
jobName

string

La matrice in YAML genera copie di un processo con input diversi nella matrice. JobName è il nome di tali input. Lunghezza massima supportata per il nome è 256 caratteri.

PhaseReference

Fase nella pipeline

Nome Tipo Descrizione
attempt

integer

Numero di tentativi della fase
phaseName

string

Nome della fase. Lunghezza massima supportata per il nome è 256 caratteri.

PipelineReference

Riferimento alla pipeline

Nome Tipo Descrizione
jobReference

JobReference

Riferimento al processo
phaseReference

PhaseReference

Riferimento alla fase.
pipelineId

integer

Riferimento alla pipeline con cui questa istanza della pipeline è correlata.
stageReference

StageReference

Riferimento alla fase.

Classe da rappresentare una raccolta di collegamenti di riferimento REST.

Nome Tipo Descrizione
links

object

Visualizzazione di lettura dei collegamenti. Poiché i collegamenti di riferimento sono in sola lettura, si vuole esporre solo i collegamenti di riferimento come sola lettura.

ReleaseReference

Riferimento a una versione.

Nome Tipo Descrizione
attempt

integer

Numero di tentativi di rilascio.
creationDate

string

Data di creazione della versione(UTC).
definitionId

integer

ID definizione di versione.
environmentCreationDate

string

Data di creazione dell'ambiente(UTC).
environmentDefinitionId

integer

ID definizione dell'ambiente di rilascio.
environmentDefinitionName

string

Nome della definizione dell'ambiente di rilascio.
environmentId

integer

ID dell'ambiente di rilascio.
environmentName

string

Nome dell'ambiente di rilascio.
id

integer

ID versione.
name

string

Nome della versione.

ResultMetadata

ResultMetadata per il risultato/conteggio specificato.

Nome Tipo Descrizione
flaky

string

Metadati flaky
rerun

string

Rieseguire i metadati

RunFilter

Questa classe viene usata per fornire i filtri usati per l'individuazione

Nome Tipo Descrizione
sourceFilter

string

filtro per le origini del test case (contenitori di test)
testCaseFilter

string

filtro per i test case

RunStatistic

Testare le statistiche di esecuzione per risultato.

Nome Tipo Descrizione
count

integer

Conteggio dei risultati dei test per il risultato specificato.
outcome

string

Risultato del test
resolutionState

TestResolutionState

Stato di risoluzione dell'esecuzione del test.
resultMetadata

ResultMetadata

ResultMetadata per il risultato/conteggio specificato.
state

string

Stato dell'esecuzione del test

ShallowReference

Riferimento astratto ad altre risorse. Questa classe viene usata per fornire ai contratti dati di compilazione un modo uniforme per fare riferimento ad altre risorse in modo che fornisca un facile attraversamento attraverso i collegamenti.

Nome Tipo Descrizione
id

string

ID della risorsa
name

string

Nome della risorsa collegata (nome della definizione, nome del controller e così via)
url

string

Collegamento http completo alla risorsa

StageReference

Fase della pipeline

Nome Tipo Descrizione
attempt

integer

Numero di tentativi di fase
stageName

string

Nome della fase. Lunghezza massima supportata per il nome è 256 caratteri.

TestEnvironment

Dettagli dell'ambiente di test.

Nome Tipo Descrizione
environmentId

string

ID ambiente di test.
environmentName

string

Nome ambiente di test.

TestResolutionState

Dettagli sullo stato della risoluzione dei test.

Nome Tipo Descrizione
id

integer

Id stato risoluzione test.
name

string

Test Resolution State Name (Nome stato risoluzione test).
project

ShallowReference

Riferimento astratto ad altre risorse. Questa classe viene usata per fornire ai contratti dati di compilazione un modo uniforme per fare riferimento ad altre risorse in modo che fornisca un facile attraversamento attraverso i collegamenti.

TestRun

Dettagli dell'esecuzione dei test.

Nome Tipo Descrizione
build

ShallowReference

Compilazione associata a questa esecuzione di test.
buildConfiguration

BuildConfiguration

Dettagli di configurazione della compilazione associati a questa esecuzione di test.
comment

string

Commenti immessi da quelli che analizzano l'esecuzione.
completedDate

string

Data completata dell'esecuzione.
controller

string

Test Run Controller.
createdDate

string

Eseguire il test CreateDate.
customFields

CustomTestField[]

Elenco di campi personalizzati per TestRun.
dropLocation

string

Percorso di rilascio per l'esecuzione del test.
dtlAutEnvironment

ShallowReference

Riferimento astratto ad altre risorse. Questa classe viene usata per fornire ai contratti dati di compilazione un modo uniforme per fare riferimento ad altre risorse in modo che fornisca un facile attraversamento attraverso i collegamenti.
dtlEnvironment

ShallowReference

Riferimento astratto ad altre risorse. Questa classe viene usata per fornire ai contratti dati di compilazione un modo uniforme per fare riferimento ad altre risorse in modo che fornisca un facile attraversamento attraverso i collegamenti.
dtlEnvironmentCreationDetails

DtlEnvironmentDetails

Si tratta di una classe temporanea per fornire i dettagli per l'ambiente di esecuzione del test.
dueDate

string

Data e ora di scadenza per l'esecuzione del test.
errorMessage

string

Messaggio di errore associato all'esecuzione.
filter

RunFilter

Questa classe viene usata per fornire i filtri usati per l'individuazione
id

integer

ID dell'esecuzione del test.
incompleteTests

integer

Numero di test incompleti.
isAutomated

boolean

true se l'esecuzione del test è automatizzata, false in caso contrario.
iteration

string

Iterazione a cui appartiene l'esecuzione.
lastUpdatedBy

IdentityRef

ID base team dell'ultima esecuzione del test aggiornato.
lastUpdatedDate

string

Ultima data e ora aggiornate
name

string

Nome dell'esecuzione dei test.
notApplicableTests

integer

Numero di test non applicabili.
owner

IdentityRef

ID Team Foundation del proprietario delle esecuzioni.
passedTests

integer

Numero di test passati nell'esecuzione
phase

string

Fase/Stato per il testRun.
pipelineReference

PipelineReference

Riferimento alla pipeline a cui appartiene questa esecuzione di test.
plan

ShallowReference

Piano di test associato a questa esecuzione di test.
postProcessState

string

Dopo lo stato del processo.
project

ShallowReference

Progetto associato a questa esecuzione.
release

ReleaseReference

Informazioni di riferimento sulla versione per l'esecuzione del test.
releaseEnvironmentUri

string

Uri dell'ambiente di rilascio per TestRun.
releaseUri

string

Uri di versione per TestRun.
revision

integer

runStatistics

RunStatistic[]

RunSummary per risultato.
startedDate

string

Data di inizio dell'esecuzione.
state

string

Stato dell'esecuzione. Tipo TestRunState Stati validi - Non specificato ,NotStarted, InProgress, Complete, In Attesa, Aborted, NeedsInvestigation
substate

TestRunSubstate

TestRun Substate.
tags

TestTag[]

Tag collegati a questa esecuzione di test.
testEnvironment

TestEnvironment

Ambiente di test associato all'esecuzione.
testMessageLogId

integer

testSettings

ShallowReference

Riferimento astratto ad altre risorse. Questa classe viene usata per fornire ai contratti dati di compilazione un modo uniforme per fare riferimento ad altre risorse in modo che fornisca un facile attraversamento attraverso i collegamenti.
totalTests

integer

Totale dei test nell'esecuzione
unanalyzedTests

integer

Numero di test non riusciti nell'esecuzione.
url

string

Url dell'esecuzione del test
webAccessUrl

string

Url di accesso Web per TestRun.

TestRunSubstate

Tipi di stati secondari per l'esecuzione di test.

Nome Tipo Descrizione
abortedBySystem

string

Stato di esecuzione quando viene interrotto dal sistema.
analyzed

string

Stato di esecuzione dopo l'analisi.
canceledByUser

string

Eseguire lo stato durante la creazione dell'ambiente.
cancellationInProgress

string

Stato di esecuzione quando l'annullamento è in corso.
creatingEnvironment

string

Eseguire lo stato durante la creazione dell'ambiente.
none

string

Eseguire con noState.
pendingAnalysis

string

Eseguire lo stato durante l'analisi in sospeso.
runningTests

string

Eseguire lo stato durante l'esecuzione dei test.
timedOut

string

Stato di esecuzione quando l'esecuzione ha timedOut.

TestTag

Tag collegato a un'esecuzione o a un risultato.

Nome Tipo Descrizione
name

string

Nome del tag, valore alfanumerico minore di 30 caratteri