Runs - Get Test Run By Id

Referenz

Service:: Test

API Version:: 7.1-preview.3

Rufen Sie einen Test ab, der anhand seiner ID ausgeführt wird.

GET https://dev.azure.com/{organization}/{project}/_apis/test/runs/{runId}?api-version=7.1-preview.3

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/test/runs/{runId}?includeDetails={includeDetails}&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
runId	path	True	integer int32	ID der abzurufenden Ausführung.
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.
includeDetails	query		boolean	Der Standardwert ist true. Sie enthält Details wie Ausführungsstatistiken, Release, Build, Testumgebung, Status nach dem Prozess und vieles mehr.

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.

Beispiele

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/runs/1?api-version=7.1-preview.3

Sample Response

Status code:: 200

{
  "id": 1,
  "name": "sprint1 (Manual)",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Runs/1",
  "isAutomated": false,
  "iteration": "Fabrikam-Fiber-TFVC\\Release 1\\Sprint 1",
  "owner": {
    "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "displayName": "Fabrikam Fiber",
    "uniqueName": "fabrikamfiber1@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
  },
  "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-04T12:50:33.17Z",
  "completedDate": "2014-05-04T12:50:31.953Z",
  "state": "Completed",
  "plan": {
    "id": "1",
    "name": "sprint1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
  },
  "postProcessState": "Complete",
  "totalTests": 1,
  "passedTests": 1,
  "createdDate": "2014-05-04T12:50:31.38Z",
  "lastUpdatedDate": "2014-05-04T12:50:31.953Z",
  "lastUpdatedBy": {
    "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "displayName": "Fabrikam Fiber",
    "uniqueName": "fabrikamfiber1@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
  },
  "revision": 3
}

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 zum Bereitstellen der Details für die Testlaufumgebung.
IdentityRef
JobReference	Auftrag in der Pipeline. Dies bezieht sich auf die Matrixierung in YAML.
PhaseReference	Phase in der Pipeline
PipelineReference	Pipelinereferenz
ReferenceLinks	Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.
ReleaseReference	Verweis auf ein Release.
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 zum Verweisen auf andere Ressourcen bereitzustellen, die eine einfache Durchquerung von Links ermöglicht.
StageReference	Phase in der Pipeline
TestEnvironment	Testumgebungsdetails.
TestResolutionState	Details zum Testauflösungsstatus.
TestRun	Testausführungsdetails.
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	Quellversion(/erster Commit) für den Build wurde ausgelöst.
targetBranchName	string	Zielbranchname.
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 zum Bereitstellen der Details für die Testlaufumgebung.

Name	Typ	Beschreibung
csmContent	string
csmParameters	string
subscriptionName	string

IdentityRef

Name	Typ	Beschreibung
_links	ReferenceLinks	Dieses Feld enthält null oder interessantere Links zum Graphthema. Diese Links können aufgerufen werden, um zusätzliche Beziehungen oder ausführlichere Informationen zu diesem Graphthema zu erhalten.
descriptor	string	Der Deskriptor ist die primäre Methode, um auf den Graph-Betreff 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 "self" des IdentityRef-Wörterbuchs "_links" verwiesen wird.
displayName	string	Dies ist der nicht eindeutige Anzeigename des Graph-Betreffs. Um dieses Feld zu ändern, müssen Sie seinen Wert im Quellanbieter ändern.
id	string
imageUrl	string	Veraltet: Im Eintrag "avatar" des IdentityRef-Wörterbuchs "_links" verfügbar
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– wird in den meisten 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 bezieht sich auf die Matrixierung in YAML.

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 maximal 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 maximal 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 verknüpft ist.
stageReference	StageReference	Verweis auf die 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ützter Sind, möchten wir sie nur als schreibgeschützter Link verfügbar machen.

ReleaseReference

Verweis auf ein Release.

Name	Typ	Beschreibung
attempt	integer	Anzahl des Releaseversuchs.
creationDate	string	Releaseerstellungsdatum (UTC).
definitionId	integer	Releasedefinitions-ID.
environmentCreationDate	string	Erstellungsdatum der Umgebung (UTC).
environmentDefinitionId	integer	Geben Sie die ID der Umgebungsdefinition frei.
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	Erneutes Ausführen von Metadaten

RunFilter

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

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

RunStatistic

Testlaufstatistiken pro Ergebnis.

Name	Typ	Beschreibung
count	integer	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 zum Verweisen auf andere Ressourcen bereitzustellen, 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