Runs - Query

Service:

Test

API Version:

7.1-preview.3

Abfragetestausführungen basierend auf Filtern. Pflichtfelder sind minLastUpdatedDate und 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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
project	path	True	string	Projekt-ID oder Projektname
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1-preview.3" festgelegt werden, um diese Version der API zu verwenden.
maxLastUpdatedDate	query	True	string date-time	Maximum Last Modified Date of run to beabfrage (Obligatorisch, Differenz zwischen min- und max. Datum kann maximal 7 Tage betragen).
minLastUpdatedDate	query	True	string date-time	Mindestdatum der letzten Änderung der ausführung, die abgefragt werden soll (Obligatorisch).
$top	query		integer int32	Anzahl der abzufragbaren Ausführungen. Grenzwert ist 100
branchName	query		string	Quellbranchname der abzufragenden Ausführungen.
buildDefIds	query		string array (int32)	Erstellen Sie Definition-IDs der zu abfragenden Ausführungen, durch Kommas getrennte Liste der gültigen IDs (Grenzwert von ids 10).
buildIds	query		string array (int32)	Erstellen Sie ids der abzufragbaren Ausführungen, kommagetrennte Liste der gültigen IDs (Grenzwert von ids 10).
continuationToken	query		string	continuationToken vom vorherigen Batch oder NULL für den ersten Batch. Es sollte nicht vom Benutzer erstellt (oder geändert werden, wenn es vom letzten Batch empfangen wurde).
isAutomated	query		boolean	Automatisierungstyp der abzufragten Ausführungen.
planIds	query		string array (int32)	Plan-IDs der zu abfragenden Ausführungen, kommagetrennte Liste der gültigen IDs (Grenzwert von ID 10).
publishContext	query		TestRunPublishContext	PublishContext der abzufragten Ausführungen.
releaseDefIds	query		string array (int32)	Releasedefinitions-IDs der zu abfragenden Ausführungen, durch Kommas getrennte Liste gültiger IDs (Grenzwert von ID 10).
releaseEnvDefIds	query		string array (int32)	Freigeben von Umgebungsdefinitions-IDs der durch Kommas getrennten Liste der gültigen Ids (Grenzwert von ID 10).
releaseEnvIds	query		string array (int32)	Freigeben von Umgebungs-IDs der zu abfragenden Ausführungen, durch Kommas getrennte Liste gültiger IDs (Grenzwert von IDs 10).
releaseIds	query		string array (int32)	Release-IDs der zu abfragenden Ausführungen, kommagetrennte Liste gültiger IDs (Grenzwert von ID 10).
runTitle	query		string	Ausführungstitel der abzufragten Ausführungen.
state	query		TestRunState	Aktueller Status der abzufragten Ausführungen.

Antworten

Name	Typ	Beschreibung
200 OK	TestRun[]	Erfolgreicher Vorgang

Sicherheit

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

Name	Beschreibung
vso.test	Ermöglicht das Lesen von Testplänen, Fällen, Ergebnissen und anderen Artefakten im Zusammenhang mit der Testverwaltung.

Definitionen

Name	Beschreibung
BuildConfiguration	BuildConfiguration-Details.
CustomTestField	Eine benutzerdefinierte Feldinformation. Zulässiger Schlüssel: Wertpaare - ( AttemptId: int value, IsTestResultFlaky: bool)
DtlEnvironmentDetails	Dies ist eine temporäre Klasse, um die Details für die Testlaufumgebung bereitzustellen.
IdentityRef
JobReference	Auftrag in der Pipeline. Dies hängt mit der Matrixerstellung in YAML zusammen.
PhaseReference	Phase in der Pipeline
PipelineReference	Pipelinereferenz
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
ReleaseReference	Verweis auf eine Version.
ResultMetadata	ResultMetadata für das angegebene Ergebnis/die angegebene Anzahl.
RunFilter	Diese Klasse wird verwendet, um die für die Ermittlung verwendeten Filter bereitzustellen.
RunStatistic	Testlaufstatistiken pro Ergebnis.
ShallowReference	Ein abstrahierter Verweis auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge mit einer einheitlichen Möglichkeit bereitzustellen, andere Ressourcen auf eine Weise zu verweisen, die eine einfache Durchquerung von Links ermöglicht.
StageReference	Phase in der Pipeline
TestEnvironment	Testumgebungsdetails.
TestResolutionState	Details zum Testauflösungsstatus.
TestRun	Testausführungsdetails.
TestRunPublishContext	PublishContext der abzufragten Ausführungen.
TestRunState
TestRunSubstate	Die Typen von Unterzuständen für die Testausführung.
TestTag	Tag, das an eine Ausführung oder ein Ergebnis angefügt ist.

BuildConfiguration

BuildConfiguration-Details.

Name	Typ	Beschreibung
branchName	string	Branchname, für den build generiert wird.
buildDefinitionId	integer	BuildDefinitionId für Build.
buildSystem	string	Buildsystem.
creationDate	string	Builderstellungsdatum.
flavor	string	Buildvariante (z. B. Build/Release).
id	integer	BuildConfiguration-ID.
number	string	Buildnummer.
platform	string	BuildConfiguration Platform.
project	ShallowReference	Projekt, das dieser BuildConfiguration zugeordnet ist.
repositoryGuid	string	Repository-Guid für den Build.
repositoryType	string	Repositorytyp (z. B. TFSGit).
sourceVersion	string	Die Quellversion(/erster Commit) für den Build wurde ausgelöst.
targetBranchName	string	Ziel-BranchName.
uri	string	Build-URI.

CustomTestField

Eine benutzerdefinierte Feldinformation. Zulässiger Schlüssel: Wertpaare - ( AttemptId: int value, IsTestResultFlaky: bool)

Name	Typ	Beschreibung
fieldName	string	Feldname
value	object	Feldwert.

DtlEnvironmentDetails

Dies ist eine temporäre Klasse, um die Details für die Testlaufumgebung bereitzustellen.

Name	Typ	Beschreibung
csmContent	string
csmParameters	string
subscriptionName	string

IdentityRef

Name	Typ	Beschreibung
_links	ReferenceLinks	Dieses Feld enthält null oder interessantere Links zum Diagrammthema. Diese Links können aufgerufen werden, um zusätzliche Beziehungen oder ausführlichere Informationen zu diesem Graph-Thema zu erhalten.
descriptor	string	Der Deskriptor ist die primäre Möglichkeit, auf den Graphengegenstand zu verweisen, während das System ausgeführt wird. In diesem Feld wird derselbe Graph-Betreff sowohl für Konten als auch für Organisationen eindeutig identifiziert.
directoryAlias	string	Veraltet: Kann abgerufen werden, indem der Graph-Benutzer abgefragt wird, auf den im Eintrag "selbst" des IdentityRef-Wörterbuchs "_links" verwiesen wird.
displayName	string	Dies ist der nicht eindeutige Anzeigename des Diagrammsubjekts. Um dieses Feld zu ändern, müssen Sie seinen Wert im Quellanbieter ändern.
id	string
imageUrl	string	Veraltet: Verfügbar im Eintrag "avatar" des IdentityRef-Wörterbuchs "_links"
inactive	boolean	Veraltet: Kann durch Abfragen des Graph-Mitgliedschaftsstatus abgerufen werden, auf den im Eintrag "membershipState" des GraphUser-Wörterbuchs "_links" verwiesen wird.
isAadIdentity	boolean	Veraltet: Kann vom Betrefftyp des Deskriptors abgeleitet werden (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Veraltet: Kann vom Betrefftyp des Deskriptors abgeleitet werden (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Veraltet: Wird in den meisten bereits vorhandenen Implementierungen von ToIdentityRef nicht verwendet.
uniqueName	string	Veraltet: Verwenden Sie stattdessen Domain+PrincipalName.
url	string	Diese URL ist die vollständige Route zur Quellressource dieses Graph-Betreffs.

JobReference

Auftrag in der Pipeline. Dies hängt mit der Matrixerstellung in YAML zusammen.

Name	Typ	Beschreibung
attempt	integer	Versuchsnummer des Auftrags
jobName	string	Die Matrixerstellung in YAML generiert Kopien eines Auftrags mit unterschiedlichen Eingaben in der Matrix. JobName ist der Name dieser Eingabe. Die maximale unterstützte Länge für name beträgt 256 Zeichen.

PhaseReference

Phase in der Pipeline

Name	Typ	Beschreibung
attempt	integer	Versuchsnummer der Phase
phaseName	string	Name der Phase. Die maximale unterstützte Länge für name beträgt 256 Zeichen.

PipelineReference

Pipelinereferenz

Name	Typ	Beschreibung
jobReference	JobReference	Referenz des Auftrags
phaseReference	PhaseReference	Referenz der Phase.
pipelineId	integer	Referenz der Pipeline, mit der diese Pipeline instance.
stageReference	StageReference	Referenz der Phase.

ReferenceLinks

Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

ReleaseReference

Verweis auf eine Version.

Name	Typ	Beschreibung
attempt	integer	Anzahl des Releaseversuchs.
creationDate	string	Erstellungsdatum der Veröffentlichung (UTC).
definitionId	integer	Releasedefinitions-ID.
environmentCreationDate	string	Umgebungserstellungsdatum (UTC).
environmentDefinitionId	integer	Release-Umgebungsdefinitions-ID.
environmentDefinitionName	string	Name der Releaseumgebungsdefinition.
environmentId	integer	Releaseumgebungs-ID.
environmentName	string	Name der Releaseumgebung.
id	integer	Release-ID.
name	string	Dieser Parameter gibt den Releasenamen an.

ResultMetadata

ResultMetadata für das angegebene Ergebnis/die angegebene Anzahl.

Name	Typ	Beschreibung
flaky	string	Flaky Metadaten
rerun	string	Metadaten erneut ausführen

RunFilter

Diese Klasse wird verwendet, um die für die Ermittlung verwendeten Filter bereitzustellen.

Name	Typ	Beschreibung
sourceFilter	string	Filtern nach den Testfallquellen (Testcontainer)
testCaseFilter	string	Filtern nach den Testfällen

RunStatistic

Testlaufstatistiken pro Ergebnis.

Name	Typ	Beschreibung
count	integer	Die Anzahl der Testergebnisse für das angegebene Ergebnis.
outcome	string	Testergebnis
resolutionState	TestResolutionState	Testlaufauflösungsstatus.
resultMetadata	ResultMetadata	ResultMetadata für das angegebene Ergebnis/die angegebene Anzahl.
state	string	Status des Testlaufs

ShallowReference

Ein abstrahierter Verweis auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge mit einer einheitlichen Möglichkeit bereitzustellen, andere Ressourcen auf eine Weise zu verweisen, die eine einfache Durchquerung von Links ermöglicht.

Name	Typ	Beschreibung
id	string	ID der Ressource
name	string	Name der verknüpften Ressource (Definitionsname, Controllername usw.)
url	string	Vollständiger HTTP-Link zur Ressource

StageReference

Phase in der Pipeline

Name	Typ	Beschreibung
attempt	integer	Versuchsanzahl der Phase
stageName	string	Name der Stufe. Die maximale unterstützte Länge für name beträgt 256 Zeichen.

TestEnvironment

Testumgebungsdetails.

Name	Typ	Beschreibung
environmentId	string	Testumgebungs-ID.
environmentName	string	Testumgebungsname.

TestResolutionState

Details zum Testauflösungsstatus.

Name	Typ	Beschreibung
id	integer	Testauflösungsstatus-ID.
name	string	Name des Testauflösungsstatus.
project	ShallowReference	Ein abstrahierter Verweis auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge mit einer einheitlichen Möglichkeit bereitzustellen, andere Ressourcen auf eine Weise zu verweisen, die eine einfache Durchquerung von Links ermöglicht.

TestRun

Testausführungsdetails.

Name	Typ	Beschreibung
build	ShallowReference	Dieser Testausführung zugeordneter Build.
buildConfiguration	BuildConfiguration	Erstellen Sie Konfigurationsdetails, die diesem Testlauf zugeordnet sind.
comment	string	Kommentare, die von personen eingegeben werden, die die Ausführung analysieren.
completedDate	string	Datum der Ausführung abgeschlossen.
controller	string	Testausführungscontroller.
createdDate	string	Test Run CreatedDate.
customFields	CustomTestField[]	Liste der benutzerdefinierten Felder für TestRun.
dropLocation	string	Speicherort für die Testausführung ablegen.
dtlAutEnvironment	ShallowReference	Ein abstrahierter Verweis auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge mit einer einheitlichen Möglichkeit bereitzustellen, andere Ressourcen auf eine Weise zu verweisen, die eine einfache Durchquerung von Links ermöglicht.
dtlEnvironment	ShallowReference	Ein abstrahierter Verweis auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge mit einer einheitlichen Möglichkeit bereitzustellen, andere Ressourcen auf eine Weise zu verweisen, die eine einfache Durchquerung von Links ermöglicht.
dtlEnvironmentCreationDetails	DtlEnvironmentDetails	Dies ist eine temporäre Klasse, um die Details für die Testlaufumgebung bereitzustellen.
dueDate	string	Fälligkeitsdatum und -uhrzeit für die Testausführung.
errorMessage	string	Fehlermeldung, die der Ausführung zugeordnet ist.
filter	RunFilter	Diese Klasse wird verwendet, um die für die Ermittlung verwendeten Filter bereitzustellen.
id	integer	ID des Testlaufs.
incompleteTests	integer	Anzahl unvollständiger Tests.
isAutomated	boolean	true, wenn die Testausführung automatisiert ist, andernfalls false.
iteration	string	Die Iteration, zu der die Ausführung gehört.
lastUpdatedBy	IdentityRef	Team Foundation-ID des letzten aktualisierten Testlaufs.
lastUpdatedDate	string	Datum und Uhrzeit der letzten Aktualisierung
name	string	Der Name des Testlaufs.
notApplicableTests	integer	Anzahl der nicht zutreffenden Tests.
owner	IdentityRef	Team Foundation-ID des Besitzers der Ausführungen.
passedTests	integer	Anzahl der bestandenen Tests in der Ausführung
phase	string	Phase/Status für den TestRun.
pipelineReference	PipelineReference	Referenz der Pipeline, zu der dieser Testlauf gehört.
plan	ShallowReference	Testplan, der diesem Testlauf zugeordnet ist.
postProcessState	string	Status nach dem Prozess.
project	ShallowReference	Projekt, das dieser Ausführung zugeordnet ist.
release	ReleaseReference	Releasereferenz für den Testlauf.
releaseEnvironmentUri	string	Geben Sie den Umgebungs-URI für TestRun frei.
releaseUri	string	Release-URI für TestRun.
revision	integer
runStatistics	RunStatistic[]	RunSummary by outcome.
startedDate	string	Startdatum der Ausführungszeit.
state	string	Der Status der Ausführung. Geben Sie TestRunState Valid states - Unpecified , NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate	TestRunSubstate	TestRun Substate.
tags	TestTag[]	Tags, die mit diesem Testlauf angefügt sind.
testEnvironment	TestEnvironment	Der Ausführung zugeordnete Testumgebung.
testMessageLogId	integer
testSettings	ShallowReference	Ein abstrahierter Verweis auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge mit einer einheitlichen Möglichkeit bereitzustellen, andere Ressourcen auf eine Weise zu verweisen, die eine einfache Durchquerung von Links ermöglicht.
totalTests	integer	Gesamtanzahl der Tests in der Ausführung
unanalyzedTests	integer	Anzahl der fehlgeschlagenen Tests in der Ausführung.
url	string	URL des Testlaufs
webAccessUrl	string	Webzugriffs-URL für TestRun.

TestRunPublishContext

PublishContext der abzufragten Ausführungen.

Name	Typ	Beschreibung
all	string	Die Ausführung wird für einen beliebigen Kontext veröffentlicht.
build	string	Die Ausführung wird für Buildkontext veröffentlicht.
release	string	Die Ausführung wird für den Releasekontext veröffentlicht.

TestRunState

Name	Typ	Beschreibung
aborted	string	Die Ausführung wurde beendet, und die verbleibenden Tests wurden abgebrochen.
completed	string	Alle Tests wurden abgeschlossen oder übersprungen.
inProgress	string	Tests werden ausgeführt.
needsInvestigation	string	Ausführung erfordert Untersuchung aufgrund eines Testpunktfehlers Dies ist ein Legacyzustand und sollte nicht mehr verwendet werden.
notStarted	string	Die Ausführung wird noch erstellt. Es wurden noch keine Tests gestartet.
unspecified	string	Wird nur während einer Aktualisierung verwendet, um den vorhandenen Wert beizubehalten.
waiting	string	Ausführung initialisiert derzeit Dies ist ein Legacyzustand und sollte nicht mehr verwendet werden.

TestRunSubstate

Die Typen von Unterzuständen für die Testausführung.

Name	Typ	Beschreibung
abortedBySystem	string	Führen Sie den Zustand aus, wenn er vom System abgebrochen wird.
analyzed	string	Ausführungsstatus nach der Analyse.
canceledByUser	string	Ausführungsstatus beim Erstellen einer Umgebung.
cancellationInProgress	string	Ausführungsstatus, wenn der Abbruch in Bearbeitung ist.
creatingEnvironment	string	Ausführungsstatus beim Erstellen einer Umgebung.
none	string	Führen Sie mit noState aus.
pendingAnalysis	string	Ausführungsstatus während der ausstehenden Analyse.
runningTests	string	Ausführungsstatus beim Ausführen von Tests.
timedOut	string	Ausführungsstatus, wenn die Ausführung timedOut hat.

TestTag

Tag, das an eine Ausführung oder ein Ergebnis angefügt ist.

Name	Typ	Beschreibung
name	string	Name des Tags, alphanumerischer Wert kleiner als 30 Zeichen