Partager via

Runs - Query

  • Référence
Service:
Test
Version d'API:
7.1

Exécutions de tests de requête basées sur des filtres. Les champs obligatoires sont minLastUpdatedDate et maxLastUpdatedDate.

GET https://dev.azure.com/{organization}/{project}/_apis/test/runs?minLastUpdatedDate={minLastUpdatedDate}&maxLastUpdatedDate={maxLastUpdatedDate}&api-version=7.1
Avec des paramètres facultatifs: 
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

Paramètres URI

Nom Dans Obligatoire Type Description
organization
 path True

string

Nom de l’organisation Azure DevOps.
project
 path True

string

ID de projet ou nom du projet
api-version
 query True

string

Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1 » pour utiliser cette version de l’API.
maxLastUpdatedDate
 query True

string (date-time)

Date maximale de dernière modification de l’exécution à interroger (obligatoire, la différence entre min et la date maximale peut être maximale de 7 jours).
minLastUpdatedDate
 query True

string (date-time)

Date minimale de dernière modification de l’exécution à interroger (obligatoire).
$top
 query

integer (int32)

Nombre d’exécutions à interroger. La limite est de 100
branchName
 query

string

Nom de la branche source des exécutions à interroger.
buildDefIds
 query

string (array (int32))

ID de définition de build des exécutions à interroger, liste séparée par des virgules d’ID valides (limite non. des ID 10).
buildIds
 query

string (array (int32))

ID de build des exécutions à interroger, liste séparée par des virgules d’ID valides (limite non. des ID 10).
continuationToken
 query

string

continuationToken reçu du lot précédent ou null pour le premier lot. Il n’est pas censé être créé (ou modifié, s’il est reçu du dernier lot) par l’utilisateur.
isAutomated
 query

boolean

Type d’automatisation des exécutions à interroger.
planIds
 query

string (array (int32))

ID de plan des exécutions à interroger, liste séparée par des virgules d’ID valides (limite non. des ID 10).
publishContext
 query

TestRunPublishContext

PublishContext des exécutions à interroger.
releaseDefIds
 query

string (array (int32))

ID de définition de mise en production des exécutions à interroger, liste séparée par des virgules d’ID valides (limite non. des ID 10).
releaseEnvDefIds
 query

string (array (int32))

Id de définition d’environnement de mise en production des exécutions à interroger, liste séparée par des virgules des ID valides (limite non. des ID 10).
releaseEnvIds
 query

string (array (int32))

Id d’environnement de mise en production des exécutions à interroger, liste séparée par des virgules d’ID valides (limite non. des ID 10).
releaseIds
 query

string (array (int32))

ID de mise en production des exécutions à interroger, liste séparée par des virgules d’ID valides (limite non. des ID 10).
runTitle
 query

string

Titre d’exécution des exécutions à interroger.
state
 query

TestRunState

État actuel des exécutions à interroger.

Réponses

Nom Type Description
200 OK

TestRun[]

opération réussie

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom Description
vso.test Accorde la possibilité de lire des plans de test, des cas, des résultats et d’autres artefacts associés à la gestion des tests.

Définitions

Nom Description
BuildConfiguration

Détails de BuildConfiguration.
CustomTestField

Informations sur les champs personnalisés. Clé autorisée : paires valeur - ( AttemptId : int value, IsTestResultFlaky : bool)
DtlEnvironmentDetails

Il s’agit d’une classe temporaire qui fournit les détails de l’environnement d’exécution de test.
IdentityRef
JobReference

Travail dans le pipeline. Cela est lié à la matrice dans YAML.
PhaseReference

Phase dans le pipeline
PipelineReference

Informations de référence sur le pipeline
ReferenceLinks

Classe à représenter une collection de liens de référence REST.
ReleaseReference

Référence à une version.
ResultMetadata

ResultMetadata pour le résultat/nombre donné.
RunFilter

Cette classe est utilisée pour fournir les filtres utilisés pour la découverte
RunStatistic

Statistiques d’exécution de test par résultat.
ShallowReference

Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de génération un moyen uniforme de référencer d’autres ressources d’une manière qui offre une traversée facile par le biais de liens.
StageReference

Étape dans le pipeline
TestEnvironment

Détails de l’environnement de test.
TestResolutionState

Détails de l’état de résolution de test.
TestRun

Détails de l’exécution de test.
TestRunPublishContext

PublishContext des exécutions à interroger.
TestRunState
TestRunSubstate

Types de sous-états pour l’exécution de test.
TestTag

Balise attachée à une exécution ou à un résultat.

BuildConfiguration

Object

Détails de BuildConfiguration.

Nom Type Description
branchName

string

Nom de branche pour lequel la build est générée.
buildDefinitionId

integer (int32)

BuildDefinitionId pour build.
buildSystem

string

Générer le système.
creationDate

string (date-time)

Date de création de build.
flavor

string

Version de build (par exemple Build/Release).
id

integer (int32)

ID buildConfiguration.
number

string

Numéro de build.
platform

string

BuildConfiguration Platform.
project

ShallowReference

Projet associé à cette BuildConfiguration.
repositoryGuid

string

Guid du référentiel pour la build.
repositoryType

string

Type de référentiel (par exemple, TFSGit).
sourceVersion

string

La version source (/première validation) de la build a été déclenchée.
targetBranchName

string

Target BranchName.
uri

string

Uri de build.

CustomTestField

Object

Informations sur les champs personnalisés. Clé autorisée : paires valeur - ( AttemptId : int value, IsTestResultFlaky : bool)

Nom Type Description
fieldName

string

Nom du champ.
value

object

Valeur du champ.

DtlEnvironmentDetails

Object

Il s’agit d’une classe temporaire qui fournit les détails de l’environnement d’exécution de test.

Nom Type Description
csmContent

string

csmParameters

string

subscriptionName

string

IdentityRef

Object
Nom Type Description
_links

ReferenceLinks

Ce champ contient zéro ou plus de liens intéressants sur le sujet du graphe. Ces liens peuvent être appelés pour obtenir des relations supplémentaires ou des informations plus détaillées sur ce sujet de graphique.
descriptor

string

Le descripteur est le principal moyen de référencer l’objet du graphique pendant l’exécution du système. Ce champ identifie de manière unique le même sujet de graphique sur les comptes et les organisations.
directoryAlias

string

Déconseillé : peut être récupéré en interrogeant l’utilisateur Graph référencé dans l’entrée « auto » du dictionnaire IdentityRef « _links »
displayName

string

Il s’agit du nom complet non unique de l’objet du graphique. Pour modifier ce champ, vous devez modifier sa valeur dans le fournisseur source.
id

string

imageUrl

string

Déconseillé - Disponible dans l’entrée « avatar » du dictionnaire IdentityRef « _links »
inactive

boolean

Déconseillé : peut être récupéré en interrogeant l’état d’appartenance Graph référencé dans l’entrée « membershipState » du dictionnaire GraphUser « _links »
isAadIdentity

boolean

Déconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer

boolean

Déconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsGroupType)
isDeletedInOrigin

boolean

profileUrl

string

Déconseillé : non utilisé dans la plupart des implémentations préexistantes de ToIdentityRef
uniqueName

string

Déconseillé : utiliser Domain+PrincipalName à la place
url

string

Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphe.

JobReference

Object

Travail dans le pipeline. Cela est lié à la matrice dans YAML.

Nom Type Description
attempt

integer (int32)

Numéro de tentative du travail
jobName

string

La matrice dans YAML génère des copies d’un travail avec différentes entrées dans la matrice. JobName est le nom de ces entrées. La longueur maximale prise en charge pour le nom est de 256 caractères.

PhaseReference

Object

Phase dans le pipeline

Nom Type Description
attempt

integer (int32)

Nombre de tentatives de la phase
phaseName

string

Nom de la phase. La longueur maximale prise en charge pour le nom est de 256 caractères.

PipelineReference

Object

Informations de référence sur le pipeline

Nom Type Description
jobReference

JobReference

Référence du travail
phaseReference

PhaseReference

Référence de la phase.
pipelineId

integer (int32)

Référence du pipeline avec lequel cette instance de pipeline est associée.
stageReference

StageReference

Référence de l’étape.
Object

Classe à représenter une collection de liens de référence REST.

Nom Type Description
links

object

Vue en lecture seule des liens. Étant donné que les liens de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

ReleaseReference

Object

Référence à une version.

Nom Type Description
attempt

integer (int32)

Nombre de tentatives de mise en production.
creationDate

string (date-time)

Date de création de publication (UTC).
definitionId

integer (int32)

ID de définition de mise en production.
environmentCreationDate

string (date-time)

Date de création de l’environnement(UTC).
environmentDefinitionId

integer (int32)

ID de définition de l’environnement de mise en production.
environmentDefinitionName

string

Nom de la définition de l’environnement de mise en production.
environmentId

integer (int32)

ID d’environnement de mise en production.
environmentName

string

Nom de l’environnement de mise en production.
id

integer (int32)

ID de mise en production.
name

string

Nom de la mise en production.

ResultMetadata

Énumération

ResultMetadata pour le résultat/nombre donné.

Valeur Description
flaky

Métadonnées flaky
rerun

Réexécuter les métadonnées

RunFilter

Object

Cette classe est utilisée pour fournir les filtres utilisés pour la découverte

Nom Type Description
sourceFilter

string

filtre pour les sources de cas de test (conteneurs de test)
testCaseFilter

string

filtre pour les cas de test

RunStatistic

Object

Statistiques d’exécution de test par résultat.

Nom Type Description
count

integer (int32)

Nombre de résultats de test pour le résultat donné.
outcome

string

Résultat du test
resolutionState

TestResolutionState

Test de l’état de résolution de l’exécution.
resultMetadata

ResultMetadata

ResultMetadata pour le résultat/nombre donné.
state

string

État de l’exécution de test

ShallowReference

Object

Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de génération un moyen uniforme de référencer d’autres ressources d’une manière qui offre une traversée facile par le biais de liens.

Nom Type Description
id

string

ID de la ressource
name

string

Nom de la ressource liée (nom de la définition, nom du contrôleur, etc.)
url

string

Lien http complet vers la ressource

StageReference

Object

Étape dans le pipeline

Nom Type Description
attempt

integer (int32)

Nombre de tentatives d’étape
stageName

string

Nom de l’étape. La longueur maximale prise en charge pour le nom est de 256 caractères.

TestEnvironment

Object

Détails de l’environnement de test.

Nom Type Description
environmentId

string (uuid)

ID d’environnement de test.
environmentName

string

Nom de l’environnement de test.

TestResolutionState

Object

Détails de l’état de résolution de test.

Nom Type Description
id

integer (int32)

ID d’état de résolution de test.
name

string

Nom de l’état de résolution de test.
project

ShallowReference

Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de génération un moyen uniforme de référencer d’autres ressources d’une manière qui offre une traversée facile par le biais de liens.

TestRun

Object

Détails de l’exécution de test.

Nom Type Description
build

ShallowReference

Générer associée à cette exécution de test.
buildConfiguration

BuildConfiguration

Détails de configuration de build associés à cette exécution de test.
comment

string

Commentaires entrés par ceux qui analysent l’exécution.
completedDate

string (date-time)

Date de fin de l’exécution.
controller

string

Test Run Controller.
createdDate

string (date-time)

Test Run CreatedDate.
customFields

CustomTestField[]

Liste des champs personnalisés pour TestRun.
dropLocation

string

Supprimer l’emplacement de l’exécution de test.
dtlAutEnvironment

ShallowReference

Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de génération un moyen uniforme de référencer d’autres ressources d’une manière qui offre une traversée facile par le biais de liens.
dtlEnvironment

ShallowReference

Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de génération un moyen uniforme de référencer d’autres ressources d’une manière qui offre une traversée facile par le biais de liens.
dtlEnvironmentCreationDetails

DtlEnvironmentDetails

Il s’agit d’une classe temporaire qui fournit les détails de l’environnement d’exécution de test.
dueDate

string (date-time)

Date et heure d’échéance de l’exécution du test.
errorMessage

string

Message d’erreur associé à l’exécution.
filter

RunFilter

Cette classe est utilisée pour fournir les filtres utilisés pour la découverte
id

integer (int32)

ID de l’exécution de test.
incompleteTests

integer (int32)

Nombre de tests incomplets.
isAutomated

boolean

true si l’exécution de test est automatisée, false sinon.
iteration

string

Itération à laquelle appartient l’exécution.
lastUpdatedBy

IdentityRef

ID de base d’équipe de la dernière mise à jour de l’exécution de test.
lastUpdatedDate

string (date-time)

Date et heure de la dernière mise à jour
name

string

Nom de l’exécution de test.
notApplicableTests

integer (int32)

Nombre de tests non applicables.
owner

IdentityRef

ID Team Foundation du propriétaire des exécutions.
passedTests

integer (int32)

Nombre de tests réussis dans l’exécution
phase

string

Phase/État pour testRun.
pipelineReference

PipelineReference

Référence du pipeline auquel appartient cette exécution de test.
plan

ShallowReference

Plan de test associé à cette exécution de test.
postProcessState

string

État post-processus.
project

ShallowReference

Projet associé à cette exécution.
release

ReleaseReference

Référence de mise en production pour l’exécution de test.
releaseEnvironmentUri

string

Uri d’environnement de mise en production pour TestRun.
releaseUri

string

URI de mise en production pour TestRun.
revision

integer (int32)

runStatistics

RunStatistic[]

RunSummary par résultat.
startedDate

string (date-time)

Date de début de l’exécution.
state

string

État de l’exécution. États valides De Type TestRunState - Non spécifié ,NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate

TestRunSubstate

TestRun Substate.
tags

TestTag[]

Balises attachées à cette série de tests.
testEnvironment

TestEnvironment

Environnement de test associé à l’exécution.
testMessageLogId

integer (int32)

testSettings

ShallowReference

Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de génération un moyen uniforme de référencer d’autres ressources d’une manière qui offre une traversée facile par le biais de liens.
totalTests

integer (int32)

Nombre total de tests dans l’exécution
unanalyzedTests

integer (int32)

Nombre de tests ayant échoué dans l’exécution.
url

string

URL de l’exécution de test
webAccessUrl

string

URL d’accès web pour TestRun.

TestRunPublishContext

Énumération

PublishContext des exécutions à interroger.

Valeur Description
all

L’exécution est publiée pour n’importe quel contexte.
build

L’exécution est publiée pour le contexte de build.
release

L’exécution est publiée pour le contexte de mise en production.

TestRunState

Énumération
Valeur Description
aborted

L’exécution est arrêtée et les tests restants ont été abandonnés
completed

Tous les tests ont été effectués ou ignorés.
inProgress

Les tests sont en cours d’exécution.
needsInvestigation

L’exécution nécessite une investigation en raison d’un échec de point de test : il s’agit d’un état hérité et ne doit pas être utilisé plus
notStarted

L’exécution est toujours en cours de création. Aucun test n’a encore commencé.
unspecified

Utilisé uniquement pendant une mise à jour pour conserver la valeur existante.
waiting

L’exécution est en cours d’initialisation : il s’agit d’un état hérité et ne doit plus être utilisé

TestRunSubstate

Énumération

Types de sous-états pour l’exécution de test.

Valeur Description
abortedBySystem

État d’exécution lorsqu’il est abandonné par le système.
analyzed

État d’exécution après analyse.
canceledByUser

État d’exécution lors de la création d’un environnement.
cancellationInProgress

État d’exécution lorsque l’annulation est en cours.
creatingEnvironment

État d’exécution lors de la création d’un environnement.
none

Exécuter avec noState.
pendingAnalysis

État d’exécution pendant l’analyse en attente.
runningTests

Exécutez l’état pendant l’exécution des tests.
timedOut

État d’exécution lorsque l’exécution a un délai d’expiration.

TestTag

Object

Balise attachée à une exécution ou à un résultat.

Nom Type Description
name

string

Nom de la balise, valeur alphanumérique inférieure à 30 caractères