Runs - Query

Dienst:

Test

API-Version:

7.1

Abfragetest wird basierend auf Filtern ausgeführt. Pflichtfelder sind "minLastUpdatedDate" und "maxLastUpdatedDate".

GET https://dev.azure.com/{organization}/{project}/_apis/test/runs?minLastUpdatedDate={minLastUpdatedDate}&maxLastUpdatedDate={maxLastUpdatedDate}&api-version=7.1

Mit optionalen Parametern:

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

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" festgelegt werden, um diese Version der API zu verwenden.
maxLastUpdatedDate	query	True	string (date-time)	Maximale Letzte Änderungsdatum, die abgefragt werden soll (Obligatorisch, Differenz zwischen min und max. Datum kann höchstens 7 Tage betragen).
minLastUpdatedDate	query	True	string (date-time)	Mindestdatum der letzten Änderung, die abgefragt werden soll (verpflichtend).
$top	query		integer (int32)	Anzahl der zu abfragenden Läufe. Der Grenzwert beträgt 100
branchName	query		string	Name des Quellzweigs der zu abfragenden Runs.
buildDefIds	query		string (array (int32))	Builddefinitions-IDs der zu abfragenden Ausführung, kommagetrennte Liste gültiger IDs (Grenzwert Nr. von IDs 10).
buildIds	query		string (array (int32))	Build-IDs der zu abfragenden Ausführung, kommagetrennte Liste gültiger IDs (Grenzwert Nr. von IDs 10).
continuationToken	query		string	continuationToken, das vom vorherigen Batch oder null für den ersten Batch empfangen wurde. Es sollte nicht vom Benutzer erstellt (oder geändert werden, wenn er vom letzten Batch empfangen wird).
isAutomated	query		boolean	Automatisierungstyp der ausführung, die abgefragt werden soll.
planIds	query		string (array (int32))	Plan-IDs der zu abfragenden Ausführung, kommagetrennte Liste gültiger IDs (Grenzwert Nr. von IDs 10).
publishContext	query		TestRunPublishContext	PublishContext der zu abfragenden Runs.
releaseDefIds	query		string (array (int32))	Versionsdefinitions-IDs der abzufragenden Runs, kommagetrennte Liste gültiger IDs (Grenzwert Nr. von IDs 10).
releaseEnvDefIds	query		string (array (int32))	Release Environment Definition IDs of the Runs to be queried, comma separated list of valid ids (limit no. of ids 10).
releaseEnvIds	query		string (array (int32))	Release Environment IDs of the Runs to be queried, comma separated list of valid ids (limit no. of ids 10).
releaseIds	query		string (array (int32))	Release-IDs der zu abfragenden Ausführung, kommagetrennte Liste gültiger IDs (Grenzwert Nr. von IDs 10).
runTitle	query		string	Run Title of the Runs to be queried.
state	query		TestRunState	Aktueller Status der zu abfragenden Runs.

Antworten

Name	Typ	Beschreibung
200 OK	TestRun[]	Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-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

Bereiche

Name	Beschreibung
vso.test	Gewährt die Möglichkeit, Testpläne, Fälle, Ergebnisse und andere artefaktbezogene Testverwaltung zu lesen.

Definitionen

Name	Beschreibung
BuildConfiguration	BuildConfiguration Details.
CustomTestField	Informationen zu benutzerdefinierten Feldern. Zulässiger Schlüssel : Wertpaare - ( AttemptId: int value, IsTestResultFlaky: bool)
DtlEnvironmentDetails	Dies ist eine temporäre Klasse, um die Details für die Testausführungsumgebung bereitzustellen.
IdentityRef
JobReference	Auftrag in Pipeline. Dies hängt mit der Matrixerstellung in YAML zusammen.
PhaseReference	Phase in der Pipeline
PipelineReference	Pipelineverweis
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.
ReleaseReference	Verweisen auf eine Version.
ResultMetadata	ResultMetadata für das angegebene Ergebnis/die Anzahl.
RunFilter	Diese Klasse wird verwendet, um die Filter bereitzustellen, die für die Ermittlung verwendet werden.
RunStatistic	Testlaufstatistiken pro Ergebnis.
ShallowReference	Ein abstrahiertes Verweisen auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge einheitlich bereitzustellen, um andere Ressourcen auf eine Weise zu referenzieren, die eine einfache Durchquerung über Links ermöglicht.
StageReference	Phase in pipeline
TestEnvironment	Testumgebungsdetails.
TestResolutionState	Details zum Testauflösungsstatus.
TestRun	Testausführungsdetails.
TestRunPublishContext	PublishContext der zu abfragenden Runs.
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

Objekt

BuildConfiguration Details.

Name	Typ	Beschreibung
branchName	string	Verzweigungsname, für den Build generiert wird.
buildDefinitionId	integer (int32)	BuildDefinitionId für Build.
buildSystem	string	Buildsystem.
creationDate	string (date-time)	Erstellungsdatum.
flavor	string	Build-Geschmack (z. B. Build/Release).
id	integer (int32)	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	Target BranchName.
uri	string	Build-URI.

CustomTestField

Objekt

Informationen zu benutzerdefinierten Feldern. Zulässiger Schlüssel : Wertpaare - ( AttemptId: int value, IsTestResultFlaky: bool)

Name	Typ	Beschreibung
fieldName	string	Flurname.
value	object	Feldwert.

DtlEnvironmentDetails

Objekt

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

Name	Typ	Beschreibung
csmContent	string
csmParameters	string
subscriptionName	string

IdentityRef

Objekt

Name	Typ	Beschreibung
_links	ReferenceLinks	Dieses Feld enthält null oder interessantere Links zum Thema Diagramm. Diese Links können aufgerufen werden, um zusätzliche Beziehungen oder ausführlichere Informationen zu diesem Diagrammbetreff zu erhalten.
descriptor	string	Der Deskriptor ist die primäre Möglichkeit, auf den Diagrammbetreff zu verweisen, während das System ausgeführt wird. In diesem Feld wird dasselbe Diagrammthema sowohl in Firmen als auch in Organisationen eindeutig identifiziert.
directoryAlias	string	Veraltet – Kann abgerufen werden, indem der Graph-Benutzer abgefragt wird, auf den im "Self"-Eintrag des IdentityRef -Wörterbuchs "_links" verwiesen wird
displayName	string	Dies ist der nicht eindeutige Anzeigename des Diagrammbetreffs. Um dieses Feld zu ändern, müssen Sie den Wert im Quellanbieter ändern.
id	string
imageUrl	string	Veraltet – Verfügbar im "Avatar"-Eintrag des IdentityRef-Wörterbuchs "_links"
inactive	boolean	Veraltet – Kann abgerufen werden, indem der Graph-Mitgliedschaftsstatus abgefragt wird, 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 – nicht in den meisten bereits vorhandenen Implementierungen von ToIdentityRef verwendet
uniqueName	string	Veraltet – Verwenden Sie stattdessen "Domain+PrincipalName".
url	string	Diese URL ist die vollständige Route zur Quellressource dieses Graph-Betreffs.

JobReference

Objekt

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

Name	Typ	Beschreibung
attempt	integer (int32)	Versuchsnummer des Auftrags
jobName	string	Durch die Matrixerstellung in YAML werden Kopien eines Auftrags mit unterschiedlichen Eingaben in der Matrix generiert. JobName ist der Name dieser Eingabe. Die maximal unterstützte Länge für den Namen beträgt 256 Zeichen.

PhaseReference

Objekt

Phase in der Pipeline

Name	Typ	Beschreibung
attempt	integer (int32)	Versuchsnummer der Phase
phaseName	string	Name der Phase. Die maximal unterstützte Länge für den Namen beträgt 256 Zeichen.

PipelineReference

Objekt

Pipelineverweis

Name	Typ	Beschreibung
jobReference	JobReference	Referenz des Auftrags
phaseReference	PhaseReference	Referenz der Phase.
pipelineId	integer (int32)	Referenz der Pipeline, mit der diese Pipelineinstanz verknüpft ist.
stageReference	StageReference	Referenz der Stufe.

ReferenceLinks

Objekt

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

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

ReleaseReference

Objekt

Verweisen auf eine Version.

Name	Typ	Beschreibung
attempt	integer (int32)	Anzahl des Veröffentlichungsversuchs.
creationDate	string (date-time)	Veröffentlichungserstellungsdatum (UTC).
definitionId	integer (int32)	Releasedefinitions-ID.
environmentCreationDate	string (date-time)	Erstellungsdatum der Umgebung(UTC).
environmentDefinitionId	integer (int32)	Release-Umgebungsdefinitions-ID.
environmentDefinitionName	string	Name der Freigabeumgebungsdefinition.
environmentId	integer (int32)	Versionsumgebungs-ID.
environmentName	string	Name der Releaseumgebung.
id	integer (int32)	Release-ID.
name	string	Releasename.

ResultMetadata

Enumeration

ResultMetadata für das angegebene Ergebnis/die Anzahl.

Wert	Beschreibung
flaky	Flaky-Metadaten
rerun	Metadaten erneut ausführen

RunFilter

Objekt

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

Name	Typ	Beschreibung
sourceFilter	string	Filter für die Testfallquellen (Testcontainer)
testCaseFilter	string	Filter für die Testfälle

RunStatistic

Objekt

Testlaufstatistiken pro Ergebnis.

Name	Typ	Beschreibung
count	integer (int32)	Testergebnisanzahl für das angegebene Ergebnis.
outcome	string	Ergebnis des Tests
resolutionState	TestResolutionState	Testausführungsauflösungsstatus.
resultMetadata	ResultMetadata	ResultMetadata für das angegebene Ergebnis/die Anzahl.
state	string	Status der Testausführung

ShallowReference

Objekt

Ein abstrahiertes Verweisen auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge einheitlich bereitzustellen, um andere Ressourcen auf eine Weise zu referenzieren, die eine einfache Durchquerung über 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

Objekt

Phase in pipeline

Name	Typ	Beschreibung
attempt	integer (int32)	Versuchsnummer der Stufe
stageName	string	Name der Stufe. Die maximal unterstützte Länge für den Namen beträgt 256 Zeichen.

TestEnvironment

Objekt

Testumgebungsdetails.

Name	Typ	Beschreibung
environmentId	string (uuid)	Testumgebungs-ID.
environmentName	string	Testumgebungsname.

TestResolutionState

Objekt

Details zum Testauflösungsstatus.

Name	Typ	Beschreibung
id	integer (int32)	Testauflösungsstatus-ID.
name	string	Name des Testauflösungsstatus.
project	ShallowReference	Ein abstrahiertes Verweisen auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge einheitlich bereitzustellen, um andere Ressourcen auf eine Weise zu referenzieren, die eine einfache Durchquerung über Links ermöglicht.

TestRun

Objekt

Testausführungsdetails.

Name	Typ	Beschreibung
build	ShallowReference	Dieser Testausführung zugeordneter Build.
buildConfiguration	BuildConfiguration	Buildkonfigurationsdetails, die dieser Testausführung zugeordnet sind.
comment	string	Kommentare, die von denen eingegeben wurden, die die Ausführung analysieren.
completedDate	string (date-time)	Abgeschlossene Datumszeit der Ausführung.
controller	string	Testausführungscontroller.
createdDate	string (date-time)	Test Run CreatedDate.
customFields	CustomTestField[]	Liste der benutzerdefinierten Felder für TestRun.
dropLocation	string	Drop Location for the test Run.
dtlAutEnvironment	ShallowReference	Ein abstrahiertes Verweisen auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge einheitlich bereitzustellen, um andere Ressourcen auf eine Weise zu referenzieren, die eine einfache Durchquerung über Links ermöglicht.
dtlEnvironment	ShallowReference	Ein abstrahiertes Verweisen auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge einheitlich bereitzustellen, um andere Ressourcen auf eine Weise zu referenzieren, die eine einfache Durchquerung über Links ermöglicht.
dtlEnvironmentCreationDetails	DtlEnvironmentDetails	Dies ist eine temporäre Klasse, um die Details für die Testausführungsumgebung bereitzustellen.
dueDate	string (date-time)	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 Filter bereitzustellen, die für die Ermittlung verwendet werden.
id	integer (int32)	ID der Testausführung.
incompleteTests	integer (int32)	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 der letzten Aktualisierung der Testausführung.
lastUpdatedDate	string (date-time)	Datum und Uhrzeit der letzten Aktualisierung
name	string	Name der Testausführung.
notApplicableTests	integer (int32)	Anzahl der nicht anwendbaren Tests.
owner	IdentityRef	Team Foundation-ID des Besitzers der Ausführung.
passedTests	integer (int32)	Anzahl der bestandenen Tests in der Ausführung
phase	string	Phase/Status für testRun.
pipelineReference	PipelineReference	Referenz der Pipeline, zu der diese Testausführung gehört.
plan	ShallowReference	Testplan, der dieser Testausführung zugeordnet ist.
postProcessState	string	Post Process State.
project	ShallowReference	Projekt, das dieser Ausführung zugeordnet ist.
release	ReleaseReference	Versionsreferenz für die Testausführung.
releaseEnvironmentUri	string	Release Environment URI für TestRun.
releaseUri	string	Release-URI für TestRun.
revision	integer (int32)
runStatistics	RunStatistic[]	RunSummary nach Ergebnis.
startedDate	string (date-time)	Startdatum der Ausführung.
state	string	Der Status der Ausführung. Typ TestRunState Gültige Zustände - nicht spezifiziert ,NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate	TestRunSubstate	TestRun-Unterstatus.
tags	TestTag[]	Tags, die an diese Testausführung angefügt sind.
testEnvironment	TestEnvironment	Testumgebung, die der Ausführung zugeordnet ist.
testMessageLogId	integer (int32)
testSettings	ShallowReference	Ein abstrahiertes Verweisen auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge einheitlich bereitzustellen, um andere Ressourcen auf eine Weise zu referenzieren, die eine einfache Durchquerung über Links ermöglicht.
totalTests	integer (int32)	Gesamttests in der Ausführung
unanalyzedTests	integer (int32)	Anzahl der fehlgeschlagenen Tests in der Ausführung.
url	string	URL der Testausführung
webAccessUrl	string	Web Access-URL für TestRun.

TestRunPublishContext

Enumeration

PublishContext der zu abfragenden Runs.

Wert	Beschreibung
all	Die Ausführung wird für einen beliebigen Kontext veröffentlicht.
build	Run wird für Buildkontext veröffentlicht.
release	Die Ausführung wird für den Versionskontext veröffentlicht.

TestRunState

Enumeration

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

TestRunSubstate

Enumeration

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

Wert	Beschreibung
abortedBySystem	Führen Sie den Zustand aus, wenn sie vom System abgebrochen wird.
analyzed	Führen Sie den Status nach der Analyse aus.
canceledByUser	Ausführungszustand beim Erstellen einer Umgebung.
cancellationInProgress	Ausführungsstatus, wenn der Abbruch in Bearbeitung ist.
creatingEnvironment	Ausführungszustand beim Erstellen einer Umgebung.
none	Ausführen mit noState.
pendingAnalysis	Ausführungsstatus beim Ausstehenden Analyse.
runningTests	Ausführungsstatus beim Ausführen von Tests.
timedOut	Run state when run has timedOut.

TestTag

Objekt

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