Condividi tramite

Runs - Query

  • Riferimento
Servizio:
Test
Versione API:
7.1

Esecuzione di test di query in base ai filtri. I campi obbligatori sono minLastUpdatedDate e maxLastUpdatedDate.

GET https://dev.azure.com/{organization}/{project}/_apis/test/runs?minLastUpdatedDate={minLastUpdatedDate}&maxLastUpdatedDate={maxLastUpdatedDate}&api-version=7.1
Con parametri facoltativi: 
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

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
api-version
 query True

string

Versione dell'API da usare. Deve essere impostato su '7.1' per usare questa versione dell'API.
maxLastUpdatedDate
 query True

string (date-time)

Data massima dell'ultima modifica dell'esecuzione su cui eseguire una query (obbligatorio, differenza tra min e max date può essere il massimo 7 giorni).
minLastUpdatedDate
 query True

string (date-time)

Data minima ultima modifica dell'esecuzione su cui eseguire una query (obbligatorio).
$top
 query

integer (int32)

Numero di esecuzioni su cui eseguire query. Il limite è 100
branchName
 query

string

Nome del ramo di origine delle esecuzioni su cui eseguire query.
buildDefIds
 query

string (array (int32))

ID definizione di compilazione delle esecuzioni su cui eseguire query, elenco delimitato da virgole di ID validi (limite n. di ID 10).
buildIds
 query

string (array (int32))

ID di compilazione delle esecuzioni su cui eseguire una query, elenco delimitato da virgole di ID validi (nessun limite di ID 10).
continuationToken
 query

string

continuationToken ricevuto dal batch precedente o null per il primo batch. Non deve essere creato (o modificato, se ricevuto dall'ultimo batch) dall'utente.
isAutomated
 query

boolean

Tipo di automazione delle esecuzioni su cui eseguire query.
planIds
 query

string (array (int32))

ID piano delle esecuzioni su cui eseguire una query, elenco delimitato da virgole di ID validi (limite n. di ID 10).
publishContext
 query

TestRunPublishContext

PublishContext delle esecuzioni su cui eseguire query.
releaseDefIds
 query

string (array (int32))

ID delle definizioni di versione delle esecuzioni su cui eseguire una query, elenco delimitato da virgole di ID validi (nessun limite di ID 10).
releaseEnvDefIds
 query

string (array (int32))

Id definizione dell'ambiente di rilascio delle esecuzioni su cui eseguire una query, elenco delimitato da virgole di ID validi (nessun limite di ID 10).
releaseEnvIds
 query

string (array (int32))

ID dell'ambiente di rilascio delle esecuzioni su cui eseguire una query, elenco delimitato da virgole di ID validi (limite n. di ID 10).
releaseIds
 query

string (array (int32))

ID versione delle esecuzioni su cui eseguire una query, elenco delimitato da virgole di ID validi (limite n. di ID 10).
runTitle
 query

string

Eseguire il titolo delle esecuzioni su cui eseguire una query.
state
 query

TestRunState

Stato corrente delle esecuzioni su cui eseguire query.

Risposte

Nome Tipo Descrizione
200 OK

TestRun[]

operazione riuscita

Sicurezza

oauth2

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: 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

Ambiti

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

Definizioni

Nome Descrizione
BuildConfiguration

Dettagli 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. Questo argomento è correlato alla matrice in YAML.
PhaseReference

Fase nella pipeline
PipelineReference

Informazioni di riferimento sulla pipeline
ReferenceLinks

Classe per 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

Statistiche di esecuzione dei test 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 da semplificare l'attraversamento dei collegamenti.
StageReference

Fase nella pipeline
TestEnvironment

Dettagli dell'ambiente di test.
TestResolutionState

Dettagli dello stato di risoluzione dei test.
TestRun

Dettagli dell'esecuzione dei test.
TestRunPublishContext

PublishContext delle esecuzioni su cui eseguire query.
TestRunState
TestRunSubstate

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

Tag associato a un'esecuzione o a un risultato.

BuildConfiguration

Object

Dettagli buildConfiguration.

Nome Tipo Descrizione
branchName

string

Nome del ramo per cui viene generata la compilazione.
buildDefinitionId

integer (int32)

BuildDefinitionId per la compilazione.
buildSystem

string

Sistema di compilazione.
creationDate

string (date-time)

Data di creazione della compilazione.
flavor

string

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

integer (int32)

Id buildConfiguration.
number

string

Numero di build.
platform

string

BuildConfiguration Platform.
project

ShallowReference

Progetto associato a 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 è stato attivato.
targetBranchName

string

Target BranchName.
uri

string

Uri di compilazione.

CustomTestField

Object

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

Object

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

Object
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 sull'oggetto grafico.
descriptor

string

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

string

Deprecato: può essere recuperato eseguendo una 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 del grafico. Per modificare questo campo, è necessario modificarne il valore 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 si fa riferimento nella voce "membershipState" del dizionario "_links" GraphUser
isAadIdentity

boolean

Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.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

Object

Processo nella pipeline. Questo argomento è correlato alla matrice in YAML.

Nome Tipo Descrizione
attempt

integer (int32)

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. La lunghezza massima supportata per il nome è 256 caratteri.

PhaseReference

Object

Fase nella pipeline

Nome Tipo Descrizione
attempt

integer (int32)

Numero di tentativi della fase
phaseName

string

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

PipelineReference

Object

Informazioni di riferimento sulla pipeline

Nome Tipo Descrizione
jobReference

JobReference

Riferimento del processo
phaseReference

PhaseReference

Riferimento della fase.
pipelineId

integer (int32)

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

StageReference

Riferimento alla fase.
Object

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome Tipo Descrizione
links

object

Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.

ReleaseReference

Object

Riferimento a una versione.

Nome Tipo Descrizione
attempt

integer (int32)

Numero di tentativi di rilascio.
creationDate

string (date-time)

Data di creazione della versione (UTC).
definitionId

integer (int32)

ID definizione versione.
environmentCreationDate

string (date-time)

Data di creazione dell'ambiente (UTC).
environmentDefinitionId

integer (int32)

ID definizione dell'ambiente di rilascio.
environmentDefinitionName

string

Nome della definizione dell'ambiente di rilascio.
environmentId

integer (int32)

ID ambiente di rilascio.
environmentName

string

Nome dell'ambiente di rilascio.
id

integer (int32)

ID versione.
name

string

Nome della versione.

ResultMetadata

Enumerazione

ResultMetadata per il risultato/conteggio specificato.

Valore Descrizione
flaky

Metadati flaky
rerun

Rieseguire i metadati

RunFilter

Object

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

Nome Tipo Descrizione
sourceFilter

string

filtrare le origini del test case (contenitori di test)
testCaseFilter

string

filtrare per i test case

RunStatistic

Object

Statistiche di esecuzione dei test per risultato.

Nome Tipo Descrizione
count

integer (int32)

Conteggio dei risultati dei test per il risultato specificato.
outcome

string

Risultato del test
resolutionState

TestResolutionState

Stato risoluzione esecuzione test.
resultMetadata

ResultMetadata

ResultMetadata per il risultato/conteggio specificato.
state

string

Stato dell'esecuzione del test

ShallowReference

Object

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 da semplificare l'attraversamento dei 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

Object

Fase nella pipeline

Nome Tipo Descrizione
attempt

integer (int32)

Numero di tentativi di fase
stageName

string

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

TestEnvironment

Object

Dettagli dell'ambiente di test.

Nome Tipo Descrizione
environmentId

string (uuid)

ID ambiente di test.
environmentName

string

Nome ambiente di test.

TestResolutionState

Object

Dettagli dello stato di risoluzione dei test.

Nome Tipo Descrizione
id

integer (int32)

Id dello stato di risoluzione del test.
name

string

Test Resolution State Name.
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 da semplificare l'attraversamento dei collegamenti.

TestRun

Object

Dettagli dell'esecuzione dei test.

Nome Tipo Descrizione
build

ShallowReference

Compilazione associata a questa esecuzione di test.
buildConfiguration

BuildConfiguration

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

string

Commenti immessi da quelli che analizzano l'esecuzione.
completedDate

string (date-time)

Data di completamento dell'esecuzione.
controller

string

Test Run Controller.
createdDate

string (date-time)

Esecuzione test CreatedDate.
customFields

CustomTestField[]

Elenco di campi personalizzati per TestRun.
dropLocation

string

Drop Location (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 da semplificare l'attraversamento dei 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 da semplificare l'attraversamento dei collegamenti.
dtlEnvironmentCreationDetails

DtlEnvironmentDetails

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

string (date-time)

Data e ora di scadenza per l'esecuzione dei 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 (int32)

ID dell'esecuzione del test.
incompleteTests

integer (int32)

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 di base del team dell'ultimo aggiornamento dell'esecuzione del test.
lastUpdatedDate

string (date-time)

Data e ora dell'ultimo aggiornamento
name

string

Nome dell'esecuzione del test.
notApplicableTests

integer (int32)

Numero di test non applicabili.
owner

IdentityRef

ID Team Foundation del proprietario delle esecuzioni.
passedTests

integer (int32)

Numero di test superati 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

Stato post-processo.
project

ShallowReference

Progetto associato a questa esecuzione.
release

ReleaseReference

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

string

Uri dell'ambiente di rilascio per TestRun.
releaseUri

string

Release Uri per TestRun.
revision

integer (int32)

runStatistics

RunStatistic[]

RunSummary per risultato.
startedDate

string (date-time)

Data di inizio dell'esecuzione.
state

string

Stato dell'esecuzione. Type TestRunState Valid states - Unspecified ,NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate

TestRunSubstate

Substate TestRun.
tags

TestTag[]

Tag associati a questa esecuzione di test.
testEnvironment

TestEnvironment

Ambiente di test associato all'esecuzione.
testMessageLogId

integer (int32)

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 da semplificare l'attraversamento dei collegamenti.
totalTests

integer (int32)

Totale test nell'esecuzione
unanalyzedTests

integer (int32)

Numero di test non riusciti nell'esecuzione.
url

string

URL dell'esecuzione del test
webAccessUrl

string

URL accesso Web per TestRun.

TestRunPublishContext

Enumerazione

PublishContext delle esecuzioni su cui eseguire query.

Valore Descrizione
all

L'esecuzione viene pubblicata per qualsiasi contesto.
build

L'esecuzione viene pubblicata per Il contesto di compilazione.
release

L'esecuzione viene pubblicata per il contesto di rilascio.

TestRunState

Enumerazione
Valore Descrizione
aborted

L'esecuzione viene arrestata e i test rimanenti sono stati interrotti
completed

Tutti i test sono stati completati o ignorati.
inProgress

I test sono in esecuzione.
needsInvestigation

L'esecuzione richiede un'indagine a causa di un errore del punto di test Questo è uno stato legacy e non deve essere usato più
notStarted

L'esecuzione è ancora in fase di creazione. Non sono ancora stati avviati test.
unspecified

Utilizzato solo durante un aggiornamento per mantenere il valore esistente.
waiting

L'esecuzione sta attualmente inizializzando Questo è uno stato legacy e non deve essere usato più

TestRunSubstate

Enumerazione

Tipi di stati secondari per l'esecuzione dei test.

Valore Descrizione
abortedBySystem

Stato di esecuzione quando viene interrotto dal sistema.
analyzed

Stato di esecuzione dopo l'analisi.
canceledByUser

Stato di esecuzione durante la creazione dell'ambiente.
cancellationInProgress

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

Stato di esecuzione durante la creazione dell'ambiente.
none

Eseguire con noState.
pendingAnalysis

Stato di esecuzione durante l'analisi in sospeso.
runningTests

Stato di esecuzione durante l'esecuzione dei test.
timedOut

Stato di esecuzione quando l'esecuzione ha timedOut.

TestTag

Object

Tag associato a un'esecuzione o a un risultato.

Nome Tipo Descrizione
name

string

Nome del tag, valore alfanumerico minore di 30 caratteri