Partager via


Runs - Create

Créez une nouvelle exécution de test.

POST https://dev.azure.com/{organization}/{project}/_apis/test/runs?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.

Corps de la demande

Nom Type Description
automated

boolean

true si l’exécution de test est automatisée, false sinon. Par défaut, elle est false.

build

ShallowReference

Référence abstraite à la build qu’elle appartient.

buildDropLocation

string

Supprimer l’emplacement de la build utilisée pour l’exécution de test.

buildFlavor

string

Saveur de la build utilisée pour l’exécution de test. (par exemple : Mise en production, débogage)

buildPlatform

string

Plateforme de la build utilisée pour l’exécution de test. (par exemple : x86, amd64)

buildReference

BuildConfiguration

BuildReference de l’exécution de test.

comment

string

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

completeDate

string

Date de fin de l’exécution.

configurationIds

integer[] (int32)

ID des configurations de test associées à l’exécution.

controller

string

Nom du contrôleur de test utilisé pour l’exécution automatisée.

customTestFields

CustomTestField[]

Propriétés supplémentaires de l’exécution de test.

dtlAutEnvironment

ShallowReference

Référence abstraite à DtlAutEnvironment.

dtlTestEnvironment

ShallowReference

Référence abstraite à DtlTestEnvironment.

dueDate

string

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

environmentDetails

DtlEnvironmentDetails

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

errorMessage

string

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

filter

RunFilter

Filtre utilisé pour découvrir l’exécution.

iteration

string

Itération dans laquelle créer l’exécution. L’itération racine du projet d’équipe sera par défaut

name

string

Nom de l’exécution de test.

owner

IdentityRef

Nom complet du propriétaire de l’exécution.

pipelineReference

PipelineReference

Référence du pipeline auquel appartient cette exécution de test. PipelineReference.PipelineId doit être égal à RunCreateModel.Build.Id

plan

ShallowReference

Référence abstraite au plan auquel elle appartient.

pointIds

integer[] (int32)

ID des points de test à utiliser dans l’exécution.

releaseEnvironmentUri

string

URI de l’environnement de mise en production associé à l’exécution.

releaseReference

ReleaseReference

Référence à la mise en production associée à l’exécution de test.

releaseUri

string

URI de mise en production associé à l’exécution.

runSummary

RunSummaryModel[]

Résumé de l’exécution pour le type d’exécution = NoConfigRun.

runTimeout

string (TimeSpan)

Intervalle de temps jusqu’à l’expiration.

sourceWorkflow

string

SourceWorkFlow(CI/CD) de l’exécution de test.

startDate

string

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

state

string

État de l’exécution. Type TestRunState États valides - NotStarted, InProgress, Waiting

tags

TestTag[]

Les balises à attacher avec l’exécution de test, un maximum de 5 balises peuvent être ajoutées pour s’exécuter.

testConfigurationsMapping

string

TestConfigurationMapping de l’exécution de test.

testEnvironmentId

string

ID de l’environnement de test associé à l’exécution.

testSettings

ShallowReference

Référence abstraite à la ressource des paramètres de test.

type

string

Type de l’exécution(RunType) Valeurs valides : (Non spécifié, Normal, Blocking, Web, MtrRunInitiatedFromWeb, RunWithDtlEnv, NoConfigRun)

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_write Accorde la possibilité de lire, de créer et de mettre à jour des plans de test, des cas, des résultats et d’autres artefacts associés à la gestion des tests.

Exemples

Exemple de requête

POST https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/runs?api-version=7.1

{
  "name": "NewTestRun",
  "plan": {
    "id": "1"
  },
  "pointIds": [
    1,
    1
  ]
}

Exemple de réponse

{
  "id": 31,
  "name": "NewTestRun",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Runs/31",
  "isAutomated": false,
  "iteration": "Fabrikam-Fiber-TFVC\\Release 1\\Sprint 1",
  "owner": {
    "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabrikamfiber3@hotmail.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
  },
  "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-28T16:39:00.44Z",
  "state": "InProgress",
  "plan": {
    "id": "1",
    "name": "sprint1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
  },
  "postProcessState": "Complete",
  "totalTests": 2,
  "incompleteTests": 2,
  "createdDate": "2014-05-28T16:39:00.4Z",
  "lastUpdatedDate": "2014-05-28T16:39:00.44Z",
  "lastUpdatedBy": {
    "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabrikamfiber3@hotmail.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
  },
  "revision": 2
}

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é.

RunCreateModel

Détails de la création d’exécution de test.

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.

RunSummaryModel

Exécutez le résumé de chaque type de test de sortie.

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.

TestOutcome
TestResolutionState

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

TestRun

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

TestRunSubstate

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

TestTag

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

BuildConfiguration

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

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

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

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

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

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

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.

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

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

ResultMetadata pour le résultat/nombre donné.

Valeur Description
flaky

Métadonnées flaky

rerun

Réexécuter les métadonnées

RunCreateModel

Détails de la création d’exécution de test.

Nom Type Description
automated

boolean

true si l’exécution de test est automatisée, false sinon. Par défaut, elle est false.

build

ShallowReference

Référence abstraite à la build qu’elle appartient.

buildDropLocation

string

Supprimer l’emplacement de la build utilisée pour l’exécution de test.

buildFlavor

string

Saveur de la build utilisée pour l’exécution de test. (par exemple : Mise en production, débogage)

buildPlatform

string

Plateforme de la build utilisée pour l’exécution de test. (par exemple : x86, amd64)

buildReference

BuildConfiguration

BuildReference de l’exécution de test.

comment

string

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

completeDate

string

Date de fin de l’exécution.

configurationIds

integer[] (int32)

ID des configurations de test associées à l’exécution.

controller

string

Nom du contrôleur de test utilisé pour l’exécution automatisée.

customTestFields

CustomTestField[]

Propriétés supplémentaires de l’exécution de test.

dtlAutEnvironment

ShallowReference

Référence abstraite à DtlAutEnvironment.

dtlTestEnvironment

ShallowReference

Référence abstraite à DtlTestEnvironment.

dueDate

string

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

environmentDetails

DtlEnvironmentDetails

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

errorMessage

string

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

filter

RunFilter

Filtre utilisé pour découvrir l’exécution.

iteration

string

Itération dans laquelle créer l’exécution. L’itération racine du projet d’équipe sera par défaut

name

string

Nom de l’exécution de test.

owner

IdentityRef

Nom complet du propriétaire de l’exécution.

pipelineReference

PipelineReference

Référence du pipeline auquel appartient cette exécution de test. PipelineReference.PipelineId doit être égal à RunCreateModel.Build.Id

plan

ShallowReference

Référence abstraite au plan auquel elle appartient.

pointIds

integer[] (int32)

ID des points de test à utiliser dans l’exécution.

releaseEnvironmentUri

string

URI de l’environnement de mise en production associé à l’exécution.

releaseReference

ReleaseReference

Référence à la mise en production associée à l’exécution de test.

releaseUri

string

URI de mise en production associé à l’exécution.

runSummary

RunSummaryModel[]

Résumé de l’exécution pour le type d’exécution = NoConfigRun.

runTimeout

string (TimeSpan)

Intervalle de temps jusqu’à l’expiration.

sourceWorkflow

string

SourceWorkFlow(CI/CD) de l’exécution de test.

startDate

string

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

state

string

État de l’exécution. Type TestRunState États valides - NotStarted, InProgress, Waiting

tags

TestTag[]

Les balises à attacher avec l’exécution de test, un maximum de 5 balises peuvent être ajoutées pour s’exécuter.

testConfigurationsMapping

string

TestConfigurationMapping de l’exécution de test.

testEnvironmentId

string

ID de l’environnement de test associé à l’exécution.

testSettings

ShallowReference

Référence abstraite à la ressource des paramètres de test.

type

string

Type de l’exécution(RunType) Valeurs valides : (Non spécifié, Normal, Blocking, Web, MtrRunInitiatedFromWeb, RunWithDtlEnv, NoConfigRun)

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

RunSummaryModel

Exécutez le résumé de chaque type de test de sortie.

Nom Type Description
duration

integer (int64)

Temps total nécessaire en millisecondes.

resultCount

integer (int32)

Nombre de résultats pour TestOutcome de résultats

testOutcome

TestOutcome

Le résumé est basé sur les résultats

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.

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 (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

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.

TestOutcome

Valeur Description
aborted

Le test a été abandonné. Cela n’a pas été provoqué par un geste de l’utilisateur, mais plutôt par une décision de cadre.

blocked

Le test a eu la chance d’être exécuté, mais n’était pas, car ITestElement.IsRunnable == false.

error

Une erreur système s’est produite pendant que nous essayions d’exécuter un test.

failed

Le test a été exécuté, mais il y a eu des problèmes. Les problèmes peuvent impliquer des exceptions ou des assertions ayant échoué.

inProgress

Le test est en cours d’exécution. Ajout de ceci pour les graphiques TCM

inconclusive

Le test s’est terminé, mais nous ne pouvons pas dire s’il a réussi ou échoué. Peut être utilisé pour les tests abandonnés...

none

Le test n’a pas été terminé, ou le type de test ne signale pas de réussite/échec.

notApplicable

Le test n’est pas applicable pour l’exécution.

notExecuted

Le test n’a pas été exécuté. Cela a été dû à un mouvement utilisateur , par exemple, le bouton d’arrêt de l’utilisateur.

notImpacted

Le test n’est pas affecté. Ajout de fot TIA.

passed

Le test a été exécuté w/o tous les problèmes.

paused

Le test est suspendu.

timeout

Délai d’expiration du test

unspecified

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

warning

Pour être utilisé par les résultats de niveau d’exécution. Ce n’est pas un échec.

TestResolutionState

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

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.

TestRunSubstate

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

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