Runs - Get Test Run By Id
Ottenere un test eseguito dall'ID.
GET https://dev.azure.com/{organization}/{project}/_apis/test/runs/{runId}?api-version=7.1-preview.3
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 |
run
|
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. |
include
|
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 |
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
{
"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 |
---|---|
Build |
Dettagli di BuildConfiguration. |
Custom |
Informazioni sul campo personalizzate. Chiave consentita: coppie valore - ( AttemptId: valore int, IsTestResultFlaky: bool) |
Dtl |
Si tratta di una classe temporanea per fornire i dettagli per l'ambiente di esecuzione del test. |
Identity |
|
Job |
Processo nella pipeline. Ciò è correlato alla matrice in YAML. |
Phase |
Fase nella pipeline |
Pipeline |
Riferimento alla pipeline |
Reference |
Classe da rappresentare una raccolta di collegamenti di riferimento REST. |
Release |
Riferimento a una versione. |
Result |
ResultMetadata per il risultato/conteggio specificato. |
Run |
Questa classe viene usata per fornire i filtri usati per l'individuazione |
Run |
Testare le statistiche di esecuzione per risultato. |
Shallow |
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. |
Stage |
Fase della pipeline |
Test |
Dettagli dell'ambiente di test. |
Test |
Dettagli sullo stato della risoluzione dei test. |
Test |
Dettagli dell'esecuzione dei test. |
Test |
Tipi di stati secondari per l'esecuzione di test. |
Test |
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 |
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 |
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 |
Riferimento al processo |
|
phaseReference |
Riferimento alla fase. |
|
pipelineId |
integer |
Riferimento alla pipeline con cui questa istanza della pipeline è correlata. |
stageReference |
Riferimento alla fase. |
ReferenceLinks
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 |
Stato di risoluzione dell'esecuzione del test. |
|
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 |
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 |
Compilazione associata a questa esecuzione di test. |
|
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 |
Elenco di campi personalizzati per TestRun. |
|
dropLocation |
string |
Percorso di rilascio per l'esecuzione del test. |
dtlAutEnvironment |
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 |
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 |
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 |
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 |
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 |
ID Team Foundation del proprietario delle esecuzioni. |
|
passedTests |
integer |
Numero di test passati nell'esecuzione |
phase |
string |
Fase/Stato per il testRun. |
pipelineReference |
Riferimento alla pipeline a cui appartiene questa esecuzione di test. |
|
plan |
Piano di test associato a questa esecuzione di test. |
|
postProcessState |
string |
Dopo lo stato del processo. |
project |
Progetto associato a questa esecuzione. |
|
release |
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 |
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 |
TestRun Substate. |
|
tags |
Test |
Tag collegati a questa esecuzione di test. |
testEnvironment |
Ambiente di test associato all'esecuzione. |
|
testMessageLogId |
integer |
|
testSettings |
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 |