Runs - Query

Service:

Test

API Version:

7.1-preview.3

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-preview.3

With optional parameters:

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-preview.3

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-preview.3 » 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 la date minimale et la date maximale peut être de 7 jours maximum).
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 d’ID valides séparés par des virgules (limite no. des ID 10).
buildIds	query		string array (int32)	ID de build des exécutions à interroger, liste séparée par des virgules des ID valides (limite no. des ID 10).
continuationToken	query		string	continuationToken reçu à partir 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 à partir 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 des ID valides (limite no. 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 des ID valides (limite no. 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 no. 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 des ID valides (limite no. des ID 10).
releaseIds	query		string array (int32)	ID de mise en production des exécutions à interroger, liste séparée par des virgules des ID valides (limite no. des ID 10).
runTitle	query		string	Titre de l’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
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

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

Définitions

Nom	Description
BuildConfiguration	Détails de buildConfiguration.
CustomTestField	Informations de champ personnalisées. 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 de série de tests.
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 pour représenter une collection de liens de référence REST.
ReleaseReference	Référence à une mise en production.
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 des séries de tests par résultat.
ShallowReference	Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de build un moyen uniforme de référencer d’autres ressources de manière à faciliter la traversée des 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 la série de tests.
TestRunPublishContext	PublishContext des exécutions à interroger.
TestRunState
TestRunSubstate	Types de sous-états pour la série de tests.
TestTag	Balise attachée à une exécution ou à un résultat.

BuildConfiguration

Détails de buildConfiguration.

Nom	Type	Description
branchName	string	Nom de la branche pour laquelle la build est générée.
buildDefinitionId	integer	BuildDefinitionId pour build.
buildSystem	string	Système de génération.
creationDate	string	Date de création de la build.
flavor	string	Version de build (par exemple Build/Release).
id	integer	BuildConfiguration Id.
number	string	Numéro de build.
platform	string	BuildConfiguration Platform.
project	ShallowReference	Projet associé à cette BuildConfiguration.
repositoryGuid	string	GUID de dépôt pour la build.
repositoryType	string	Type de dépôt (par exemple, TFSGit).
sourceVersion	string	La version source(/la première validation) de la build a été déclenchée.
targetBranchName	string	BranchName cible.
uri	string	URI de build.

CustomTestField

Informations de champ personnalisées. Clé autorisée : paires valeur - ( AttemptId: int value, IsTestResultFlaky: bool)

Nom	Type	Description
fieldName	string	le nom du champ ;
value	object	Valeur de champ.

DtlEnvironmentDetails

Il s’agit d’une classe temporaire qui fournit les détails de l’environnement de série de tests.

Nom	Type	Description
csmContent	string
csmParameters	string
subscriptionName	string

IdentityRef

Nom	Type	Description
_links	ReferenceLinks	Ce champ contient zéro ou plus de liens intéressants sur l’objet du graphique. 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 dans 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 « self » du dictionnaire IdentityRef « _links »
displayName	string	Il s’agit du nom d’affichage 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éprécié : 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éprécié : peut être déduit du type d’objet du descripteur (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Déprécié : 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é : utilisez à la place Domain+PrincipalName
url	string	Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphique.

JobReference

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

Nom	Type	Description
attempt	integer	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 name est de 256 caractères.

PhaseReference

Phase dans le pipeline

Nom	Type	Description
attempt	integer	Numéro de tentative de la phase
phaseName	string	Nom de la phase. La longueur maximale prise en charge pour name est de 256 caractères.

PipelineReference

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	Référence du pipeline avec lequel ce pipeline instance est lié.
stageReference	StageReference	Référence de la phase.

ReferenceLinks

Classe pour 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 référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

ReleaseReference

Référence à une mise en production.

Nom	Type	Description
attempt	integer	Nombre de tentatives de mise en production.
creationDate	string	Date de création de la mise en production (UTC).
definitionId	integer	ID de définition de mise en production.
environmentCreationDate	string	Date de création de l’environnement (UTC).
environmentDefinitionId	integer	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	ID d’environnement de mise en production.
environmentName	string	Nom de l’environnement de mise en production.
id	integer	ID de mise en production.
name	string	Nom de la version.

ResultMetadata

ResultMetadata pour le résultat/nombre donné.

Nom	Type	Description
flaky	string	Métadonnées flaky
rerun	string	Réexécuter les métadonnées

RunFilter

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

Statistiques des séries de tests par résultat.

Nom	Type	Description
count	integer	Nombre de résultats de test pour le résultat donné.
outcome	string	Résultat du test
resolutionState	TestResolutionState	État de résolution de l’exécution de test.
resultMetadata	ResultMetadata	ResultMetadata pour le résultat/nombre donné.
state	string	État de la série de tests

ShallowReference

Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de build un moyen uniforme de référencer d’autres ressources de manière à faciliter la traversée des 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

Étape dans le pipeline

Nom	Type	Description
attempt	integer	Nombre de tentatives d’étape
stageName	string	Nom de la phase. La longueur maximale prise en charge pour name est de 256 caractères.

TestEnvironment

Détails de l’environnement de test.

Nom	Type	Description
environmentId	string	ID d’environnement de test.
environmentName	string	Nom de l’environnement de test.

TestResolutionState

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

Nom	Type	Description
id	integer	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 build un moyen uniforme de référencer d’autres ressources de manière à faciliter la traversée des liens.

TestRun

Détails de la série de tests.

Nom	Type	Description
build	ShallowReference	Build associée à cette série de tests.
buildConfiguration	BuildConfiguration	Détails de configuration de build associés à cette série de tests.
comment	string	Commentaires entrés par ceux qui analysent l’exécution.
completedDate	string	Date d’exécution de l’exécution.
controller	string	Contrôleur d’exécution de test.
createdDate	string	Exécution de test 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 build un moyen uniforme de référencer d’autres ressources de manière à faciliter la traversée des liens.
dtlEnvironment	ShallowReference	Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de build un moyen uniforme de référencer d’autres ressources de manière à faciliter la traversée des liens.
dtlEnvironmentCreationDetails	DtlEnvironmentDetails	Il s’agit d’une classe temporaire qui fournit les détails de l’environnement de série de tests.
dueDate	string	Date et heure d’échéance de la série de tests.
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	ID de la série de tests.
incompleteTests	integer	Nombre de tests incomplets.
isAutomated	boolean	true si la série de tests est automatisée, false dans le cas contraire.
iteration	string	Itération à laquelle appartient l’exécution.
lastUpdatedBy	IdentityRef	ID de base d’équipe de la dernière mise à jour de la série de tests.
lastUpdatedDate	string	Date et heure de la dernière mise à jour
name	string	Nom de la série de tests.
notApplicableTests	integer	Nombre de tests non applicables.
owner	IdentityRef	ID Team Foundation du propriétaire des exécutions.
passedTests	integer	Nombre de tests réussis dans l’exécution
phase	string	Phase/État pour le testRun.
pipelineReference	PipelineReference	Référence du pipeline auquel appartient cette série de tests.
plan	ShallowReference	Plan de test associé à cette série de tests.
postProcessState	string	Post-processus.
project	ShallowReference	Projet associé à cette exécution.
release	ReleaseReference	Référence de mise en production pour la série de tests.
releaseEnvironmentUri	string	URI d’environnement de mise en production pour TestRun.
releaseUri	string	URI de mise en production pour TestRun.
revision	integer
runStatistics	RunStatistic[]	RunSummary par résultat.
startedDate	string	Date de début heure de l’exécution.
state	string	État de l’exécution. Type TestRunState États valides - Non spécifié, NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate	TestRunSubstate	TestRun Substate.
tags	TestTag[]	Balises jointes à cette série de tests.
testEnvironment	TestEnvironment	Environnement de test associé à l’exécution.
testMessageLogId	integer
testSettings	ShallowReference	Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de build un moyen uniforme de référencer d’autres ressources de manière à faciliter la traversée des liens.
totalTests	integer	Nombre total de tests en cours d’exécution
unanalyzedTests	integer	Nombre d’échecs de tests au cours de l’exécution.
url	string	URL de la série de tests
webAccessUrl	string	URL d’accès web pour TestRun.

TestRunPublishContext

PublishContext des exécutions à interroger.

Nom	Type	Description
all	string	L’exécution est publiée pour n’importe quel contexte.
build	string	L’exécution est publiée pour le contexte de build.
release	string	L’exécution est publiée pour le contexte de mise en production.

TestRunState

Nom	Type	Description
aborted	string	L’exécution est arrêtée et les tests restants ont été abandonnés
completed	string	Tous les tests sont terminés ou ont été ignorés.
inProgress	string	Des tests sont en cours d’exécution.
needsInvestigation	string	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 plus être utilisé
notStarted	string	L’exécution est toujours en cours de création. Aucun test n’a encore commencé.
unspecified	string	Utilisé uniquement pendant une mise à jour pour conserver la valeur existante.
waiting	string	L’exécution est en cours d’initialisation Il s’agit d’un état hérité et ne doit plus être utilisé

TestRunSubstate

Types de sous-états pour la série de tests.

Nom	Type	Description
abortedBySystem	string	État d’exécution lorsqu’il est abandonné par le système.
analyzed	string	État d’exécution après analyse.
canceledByUser	string	État d’exécution lors de la création d’un environnement.
cancellationInProgress	string	État d’exécution lorsque l’annulation est en cours.
creatingEnvironment	string	État d’exécution lors de la création d’un environnement.
none	string	Exécutez avec noState.
pendingAnalysis	string	État d’exécution pendant l’analyse en attente.
runningTests	string	État d’exécution lors de l’exécution des tests.
timedOut	string	État d’exécution lorsque l’exécution a timedOut.

TestTag

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