Compartir a través de


Runs - Get Test Run By Id

Obtenga una prueba ejecutada por su identificador.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
organization
path True

string

El nombre de la organización de Azure DevOps.

project
path True

string

Id. de proyecto o nombre del proyecto

runId
path True

integer

int32

Identificador de la ejecución que se va a obtener.

api-version
query True

string

Versión de la API que se va a usar. Debe establecerse en "7.1-preview.3" para usar esta versión de la API.

includeDetails
query

boolean

El valor predeterminado es true. Incluye detalles como las estadísticas de ejecución, la versión, la compilación, el entorno de prueba, el estado posterior al proceso, etc.

Respuestas

Nombre Tipo Description
200 OK

TestRun

operación correcta

Seguridad

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

Nombre Description
vso.test Concede la capacidad de leer planes de prueba, casos, resultados y otros artefactos relacionados con la administración de pruebas.

Ejemplos

Sample Request

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

Sample Response

{
  "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
}

Definiciones

Nombre Description
BuildConfiguration

Detalles de BuildConfiguration.

CustomTestField

Información de campo personalizada. Clave permitida: pares de valor - ( AttemptId: int value, IsTestResultFlaky: bool)

DtlEnvironmentDetails

Se trata de una clase temporal para proporcionar los detalles del entorno de ejecución de pruebas.

IdentityRef
JobReference

Trabajo en canalización. Esto está relacionado con la matriz en YAML.

PhaseReference

Fase en la canalización

PipelineReference

Referencia de canalización

ReferenceLinks

Clase que se va a representar una colección de vínculos de referencia de REST.

ReleaseReference

Referencia a una versión.

ResultMetadata

ResultMetadata para el resultado o recuento especificados.

RunFilter

Esta clase se usa para proporcionar los filtros usados para la detección.

RunStatistic

Estadísticas de ejecución de pruebas por resultado.

ShallowReference

Referencia abstracta a algún otro recurso. Esta clase se usa para proporcionar los contratos de datos de compilación con una manera uniforme de hacer referencia a otros recursos de una manera que proporciona un recorrido fácil a través de vínculos.

StageReference

Fase en la canalización

TestEnvironment

Detalles del entorno de prueba.

TestResolutionState

Detalles del estado de resolución de pruebas.

TestRun

Detalles de la ejecución de pruebas.

TestRunSubstate

Los tipos de sub estados para la ejecución de pruebas.

TestTag

Etiqueta adjunta a una ejecución o resultado.

BuildConfiguration

Detalles de BuildConfiguration.

Nombre Tipo Description
branchName

string

Nombre de rama para el que se genera la compilación.

buildDefinitionId

integer

BuildDefinitionId para la compilación.

buildSystem

string

Sistema de compilación.

creationDate

string

Fecha de creación de la compilación.

flavor

string

Tipo de compilación (por ejemplo, compilación/versión).

id

integer

BuildConfiguration Id.

number

string

Número de compilación.

platform

string

BuildConfiguration Platform.

project

ShallowReference

Proyecto asociado a este buildConfiguration.

repositoryGuid

string

Guid de repositorio para la compilación.

repositoryType

string

Tipo de repositorio (por ejemplo, TFSGit).

sourceVersion

string

Se desencadenó la versión de origen (/primera confirmación) de la compilación.

targetBranchName

string

BranchName de destino.

uri

string

Uri de compilación.

CustomTestField

Información de campo personalizada. Clave permitida: pares de valor - ( AttemptId: int value, IsTestResultFlaky: bool)

Nombre Tipo Description
fieldName

string

Nombre del campo.

value

object

Valor del campo.

DtlEnvironmentDetails

Se trata de una clase temporal para proporcionar los detalles del entorno de ejecución de pruebas.

Nombre Tipo Description
csmContent

string

csmParameters

string

subscriptionName

string

IdentityRef

Nombre Tipo Description
_links

ReferenceLinks

Este campo contiene cero o más vínculos interesantes sobre el tema del grafo. Estos vínculos se pueden invocar para obtener relaciones adicionales o información más detallada sobre este tema del grafo.

descriptor

string

El descriptor es la forma principal de hacer referencia al asunto del grafo mientras se ejecuta el sistema. Este campo identificará de forma única el mismo asunto del grafo en cuentas y organizaciones.

directoryAlias

string

En desuso: se puede recuperar consultando el usuario de Graph al que se hace referencia en la entrada "self" del diccionario IdentityRef "_links".

displayName

string

Este es el nombre para mostrar no único del asunto del grafo. Para cambiar este campo, debe modificar su valor en el proveedor de origen.

id

string

imageUrl

string

En desuso: disponible en la entrada "avatar" del diccionario "_links" de IdentityRef

inactive

boolean

En desuso: se puede recuperar consultando el estado de pertenencia de Graph al que se hace referencia en la entrada "membershipState" del diccionario GraphUser "_links".

isAadIdentity

boolean

En desuso: se puede deducir del tipo de asunto del descriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

En desuso: se puede deducir del tipo de sujeto del descriptor (Descriptor.IsGroupType)

isDeletedInOrigin

boolean

profileUrl

string

En desuso: no en uso en la mayoría de las implementaciones preexistentes de ToIdentityRef

uniqueName

string

En desuso: use Domain+PrincipalName en su lugar.

url

string

Esta dirección URL es la ruta completa al recurso de origen de este tema del grafo.

JobReference

Trabajo en canalización. Esto está relacionado con la matriz en YAML.

Nombre Tipo Description
attempt

integer

Número de intentos del trabajo

jobName

string

La matriz en YAML genera copias de un trabajo con entradas diferentes en la matriz. JobName es el nombre de esa entrada. La longitud máxima admitida para el nombre es de 256 caracteres.

PhaseReference

Fase en la canalización

Nombre Tipo Description
attempt

integer

Número de intentos de la fase

phaseName

string

Nombre de la fase. La longitud máxima admitida para el nombre es de 256 caracteres.

PipelineReference

Referencia de canalización

Nombre Tipo Description
jobReference

JobReference

Referencia del trabajo

phaseReference

PhaseReference

Referencia de la fase.

pipelineId

integer

Referencia de la canalización con la que está relacionada esta instancia de canalización.

stageReference

StageReference

Referencia de la fase.

Clase que se va a representar una colección de vínculos de referencia de REST.

Nombre Tipo Description
links

object

Vista de lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.

ReleaseReference

Referencia a una versión.

Nombre Tipo Description
attempt

integer

Número de intentos de lanzamiento.

creationDate

string

Fecha de creación de la versión (UTC).

definitionId

integer

Id. de definición de versión.

environmentCreationDate

string

Fecha de creación del entorno (UTC).

environmentDefinitionId

integer

Id. de definición del entorno de versión.

environmentDefinitionName

string

Nombre de definición del entorno de versión.

environmentId

integer

Id. del entorno de versión.

environmentName

string

Nombre del entorno de versión.

id

integer

Id. de versión.

name

string

Nombre de la versión.

ResultMetadata

ResultMetadata para el resultado o recuento especificados.

Nombre Tipo Description
flaky

string

Metadatos poco finos

rerun

string

Volver a ejecutar metadatos

RunFilter

Esta clase se usa para proporcionar los filtros usados para la detección.

Nombre Tipo Description
sourceFilter

string

filtro para los orígenes de casos de prueba (contenedores de prueba)

testCaseFilter

string

filtro para los casos de prueba

RunStatistic

Estadísticas de ejecución de pruebas por resultado.

Nombre Tipo Description
count

integer

Recuento de resultados de la prueba para el resultado dado.

outcome

string

Resultado de la prueba

resolutionState

TestResolutionState

Estado de resolución de ejecución de prueba.

resultMetadata

ResultMetadata

ResultMetadata para el resultado o recuento especificados.

state

string

Estado de la ejecución de prueba

ShallowReference

Referencia abstracta a algún otro recurso. Esta clase se usa para proporcionar los contratos de datos de compilación con una manera uniforme de hacer referencia a otros recursos de una manera que proporciona un recorrido fácil a través de vínculos.

Nombre Tipo Description
id

string

Identificador del recurso

name

string

Nombre del recurso vinculado (nombre de definición, nombre del controlador, etc.)

url

string

Vínculo HTTP completo al recurso

StageReference

Fase en la canalización

Nombre Tipo Description
attempt

integer

Número de intentos de fase

stageName

string

Nombre de la fase. La longitud máxima admitida para el nombre es de 256 caracteres.

TestEnvironment

Detalles del entorno de prueba.

Nombre Tipo Description
environmentId

string

Id. del entorno de prueba.

environmentName

string

Nombre del entorno de prueba.

TestResolutionState

Detalles del estado de resolución de pruebas.

Nombre Tipo Description
id

integer

Id. de estado de resolución de prueba.

name

string

Nombre del estado de resolución de pruebas.

project

ShallowReference

Referencia abstracta a algún otro recurso. Esta clase se usa para proporcionar los contratos de datos de compilación con una manera uniforme de hacer referencia a otros recursos de una manera que proporciona un recorrido fácil a través de vínculos.

TestRun

Detalles de la ejecución de pruebas.

Nombre Tipo Description
build

ShallowReference

Compilación asociada a esta ejecución de prueba.

buildConfiguration

BuildConfiguration

Detalles de configuración de compilación asociados a esta ejecución de prueba.

comment

string

Comentarios introducidos por aquellos que analizan la ejecución.

completedDate

string

Fecha y hora de finalización de la ejecución.

controller

string

Controlador de ejecución de prueba.

createdDate

string

Ejecutar prueba CreatedDate.

customFields

CustomTestField[]

Lista de campos personalizados para TestRun.

dropLocation

string

Coloque ubicación para la ejecución de prueba.

dtlAutEnvironment

ShallowReference

Referencia abstracta a algún otro recurso. Esta clase se usa para proporcionar los contratos de datos de compilación con una manera uniforme de hacer referencia a otros recursos de una manera que proporciona un recorrido fácil a través de vínculos.

dtlEnvironment

ShallowReference

Referencia abstracta a algún otro recurso. Esta clase se usa para proporcionar los contratos de datos de compilación con una manera uniforme de hacer referencia a otros recursos de una manera que proporciona un recorrido fácil a través de vínculos.

dtlEnvironmentCreationDetails

DtlEnvironmentDetails

Se trata de una clase temporal para proporcionar los detalles del entorno de ejecución de pruebas.

dueDate

string

Fecha y hora de vencimiento para la ejecución de pruebas.

errorMessage

string

Mensaje de error asociado a la ejecución.

filter

RunFilter

Esta clase se usa para proporcionar los filtros usados para la detección.

id

integer

Identificador de la ejecución de pruebas.

incompleteTests

integer

Número de pruebas incompletas.

isAutomated

boolean

True si la ejecución de pruebas está automatizada; de lo contrario, false.

iteration

string

Iteración a la que pertenece la ejecución.

lastUpdatedBy

IdentityRef

Id. de Team Foundation de la última actualización de la ejecución de pruebas.

lastUpdatedDate

string

Fecha y hora de la última actualización

name

string

Nombre de la ejecución de pruebas.

notApplicableTests

integer

Número de pruebas no aplicables.

owner

IdentityRef

Identificador de Team Foundation del propietario de las ejecuciones.

passedTests

integer

Número de pruebas superadas en la ejecución

phase

string

Fase o estado para testRun.

pipelineReference

PipelineReference

Referencia de la canalización a la que pertenece esta ejecución de prueba.

plan

ShallowReference

Plan de pruebas asociado a esta ejecución de pruebas.

postProcessState

string

Estado posterior al proceso.

project

ShallowReference

Proyecto asociado a esta ejecución.

release

ReleaseReference

Referencia de versión para la ejecución de pruebas.

releaseEnvironmentUri

string

Uri del entorno de versión para TestRun.

releaseUri

string

URI de versión para TestRun.

revision

integer

runStatistics

RunStatistic[]

RunSummary por resultado.

startedDate

string

Fecha y hora de inicio de la ejecución.

state

string

Estado de la ejecución. Tipo TestRunState Estados válidos: Sin especificar , NotStarted, InProgress, Completed, Waiting, Aborted, Needs Investigation

substate

TestRunSubstate

TestRun Substate(Ejecutar subestado).

tags

TestTag[]

Etiquetas asociadas a esta ejecución de prueba.

testEnvironment

TestEnvironment

Entorno de prueba asociado a la ejecución.

testMessageLogId

integer

testSettings

ShallowReference

Referencia abstracta a algún otro recurso. Esta clase se usa para proporcionar los contratos de datos de compilación con una manera uniforme de hacer referencia a otros recursos de una manera que proporciona un recorrido fácil a través de vínculos.

totalTests

integer

Total de pruebas en la ejecución

unanalyzedTests

integer

Número de pruebas con error en la ejecución.

url

string

Dirección URL de la ejecución de pruebas

webAccessUrl

string

Dirección URL de acceso web para TestRun.

TestRunSubstate

Los tipos de sub estados para la ejecución de pruebas.

Nombre Tipo Description
abortedBySystem

string

Estado de ejecución cuando el sistema lo anula.

analyzed

string

Estado de ejecución después de analizarse.

canceledByUser

string

Estado de ejecución al crear entorno.

cancellationInProgress

string

Estado de ejecución cuando la cancelación está en curso.

creatingEnvironment

string

Estado de ejecución al crear entorno.

none

string

Ejecute con noState.

pendingAnalysis

string

Estado de ejecución mientras se está pendiente de análisis.

runningTests

string

Estado de ejecución mientras se ejecutan pruebas.

timedOut

string

Estado de ejecución cuando la ejecución tiene timedOut.

TestTag

Etiqueta adjunta a una ejecución o resultado.

Nombre Tipo Description
name

string

Nombre de la etiqueta, valor alfanumérico inferior a 30 caracteres