Compartir a través de

Runs - Query

  • Referencia
Servicio:
Test
Versión de la API:
7.1

Ejecuciones de pruebas de consulta basadas en filtros. Los campos obligatorios son minLastUpdatedDate y maxLastUpdatedDate.

GET https://dev.azure.com/{organization}/{project}/_apis/test/runs?minLastUpdatedDate={minLastUpdatedDate}&maxLastUpdatedDate={maxLastUpdatedDate}&api-version=7.1
Con parámetros opcionales: 
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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
organization
 path True

string

Nombre de la organización de Azure DevOps.
project
 path True

string

Id. de proyecto o nombre del proyecto
api-version
 query True

string

Versión de la API que se va a usar. Debe establecerse en "7.1" para usar esta versión de la API.
maxLastUpdatedDate
 query True

string (date-time)

La fecha máxima de última modificación de la ejecución que se va a consultar (obligatoria, la diferencia entre la fecha mínima y máxima puede ser de más de 7 días).
minLastUpdatedDate
 query True

string (date-time)

Fecha mínima de última modificación de la ejecución que se va a consultar (obligatorio).
$top
 query

integer (int32)

Número de ejecuciones que se van a consultar. El límite es 100
branchName
 query

string

Nombre de rama de origen de las ejecuciones que se van a consultar.
buildDefIds
 query

string (array (int32))

Identificadores de definición de compilación de las ejecuciones que se van a consultar, lista separada por comas de identificadores válidos (límite no. de ids 10).
buildIds
 query

string (array (int32))

Identificadores de compilación de las ejecuciones que se van a consultar, lista separada por comas de identificadores válidos (límite no. de ids 10).
continuationToken
 query

string

continuationToken recibido del lote anterior o null para el primer lote. No se supone que el usuario cree (o modifique, si lo recibe del último lote).
isAutomated
 query

boolean

Tipo de automatización de las ejecuciones que se van a consultar.
planIds
 query

string (array (int32))

Identificadores de plan de las ejecuciones que se van a consultar, lista separada por comas de identificadores válidos (límite no. de ids 10).
publishContext
 query

TestRunPublishContext

PublishContext de las ejecuciones que se van a consultar.
releaseDefIds
 query

string (array (int32))

Identificadores de definición de versión de las ejecuciones que se van a consultar, lista separada por comas de identificadores válidos (límite no. de ids 10).
releaseEnvDefIds
 query

string (array (int32))

Identificadores de definición del entorno de versión de las ejecuciones que se van a consultar, lista separada por comas de identificadores válidos (límite no. de ids 10).
releaseEnvIds
 query

string (array (int32))

Identificadores de entorno de versión de las ejecuciones que se van a consultar, lista separada por comas de identificadores válidos (límite no. de ids 10).
releaseIds
 query

string (array (int32))

Identificadores de versión de las ejecuciones que se van a consultar, lista separada por comas de identificadores válidos (límite no. de ids 10).
runTitle
 query

string

Ejecute Título de las ejecuciones que se van a consultar.
state
 query

TestRunState

Estado actual de las ejecuciones que se van a consultar.

Respuestas

Nombre Tipo Description
200 OK

TestRun[]

operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del token: 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

Ámbitos

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

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 representa una colección de vínculos de referencia 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

Pruebas de estadísticas de ejecución 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.
TestRunPublishContext

PublishContext de las ejecuciones que se van a consultar.
TestRunState
TestRunSubstate

Los tipos de subes estados para la ejecución de pruebas.
TestTag

Etiqueta asociada a una ejecución o resultado.

BuildConfiguration

Object

Detalles de buildConfiguration.

Nombre Tipo Description
branchName

string

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

integer (int32)

BuildDefinitionId para la compilación.
buildSystem

string

Sistema de compilación.
creationDate

string (date-time)

Fecha de creación de la compilación.
flavor

string

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

integer (int32)

BuildConfiguration Id.
number

string

Número de compilación.
platform

string

BuildConfiguration Platform.
project

ShallowReference

Proyecto asociado a esta buildConfiguration.
repositoryGuid

string

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

Object

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 de campo.

DtlEnvironmentDetails

Object

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

Object
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 al 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" 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 "_links" de GraphUser.
isAadIdentity

boolean

En desuso: se puede deducir del tipo de sujeto 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

Object

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

Nombre Tipo Description
attempt

integer (int32)

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

Object

Fase en la canalización

Nombre Tipo Description
attempt

integer (int32)

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

Object

Referencia de canalización

Nombre Tipo Description
jobReference

JobReference

Referencia del trabajo
phaseReference

PhaseReference

Referencia de la fase.
pipelineId

integer (int32)

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

StageReference

Referencia de la fase.
Object

Clase que representa una colección de vínculos de referencia rest.

Nombre Tipo Description
links

object

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

ReleaseReference

Object

Referencia a una versión.

Nombre Tipo Description
attempt

integer (int32)

Número de intentos de lanzamiento.
creationDate

string (date-time)

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

integer (int32)

Identificador de definición de versión.
environmentCreationDate

string (date-time)

Fecha de creación del entorno (UTC).
environmentDefinitionId

integer (int32)

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

string

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

integer (int32)

Id. de entorno de versión.
environmentName

string

Nombre del entorno de versión.
id

integer (int32)

Id. de versión.
name

string

Nombre de la versión.

ResultMetadata

Enumeración

ResultMetadata para el resultado o recuento especificados.

Valor Description
flaky

Metadatos poco confiables
rerun

Volver a ejecutar metadatos

RunFilter

Object

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

Object

Pruebas de estadísticas de ejecución por resultado.

Nombre Tipo Description
count

integer (int32)

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 pruebas

ShallowReference

Object

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

Object

Fase en la canalización

Nombre Tipo Description
attempt

integer (int32)

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

Object

Detalles del entorno de prueba.

Nombre Tipo Description
environmentId

string (uuid)

Id. del entorno de prueba.
environmentName

string

Nombre del entorno de prueba.

TestResolutionState

Object

Detalles del estado de resolución de pruebas.

Nombre Tipo Description
id

integer (int32)

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

Object

Detalles de la ejecución de pruebas.

Nombre Tipo Description
build

ShallowReference

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

BuildConfiguration

Compile los detalles de configuración asociados a esta ejecución de prueba.
comment

string

Comentarios introducidos por los que analizan la ejecución.
completedDate

string (date-time)

Fecha de finalización de la ejecución.
controller

string

Probar controlador de ejecución.
createdDate

string (date-time)

Prueba ejecutar 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 (date-time)

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

Identificador de la ejecución de pruebas.
incompleteTests

integer (int32)

Número de pruebas incompletas.
isAutomated

boolean

True si la ejecución de pruebas está automatizada, false en caso contrario.
iteration

string

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

IdentityRef

Identificador de base del equipo de la última actualización de la ejecución de pruebas.
lastUpdatedDate

string (date-time)

Fecha y hora actualizadas por última vez
name

string

Nombre de la ejecución de pruebas.
notApplicableTests

integer (int32)

Número de pruebas no aplicables.
owner

IdentityRef

Identificador de Team Foundation del propietario de las ejecuciones.
passedTests

integer (int32)

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 prueba asociado a esta ejecución de pruebas.
postProcessState

string

Estado postproceso.
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 (int32)

runStatistics

RunStatistic[]

RunSummary por resultado.
startedDate

string (date-time)

Fecha de inicio de la ejecución.
state

string

Estado de la ejecución. Escriba TestRunState Estados válidos: Sin especificar , NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate

TestRunSubstate

TestRun Substate.
tags

TestTag[]

Etiquetas adjuntas a esta ejecución de prueba.
testEnvironment

TestEnvironment

Entorno de prueba asociado a la ejecución.
testMessageLogId

integer (int32)

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

Total de pruebas en la ejecución
unanalyzedTests

integer (int32)

Número de pruebas con errores 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.

TestRunPublishContext

Enumeración

PublishContext de las ejecuciones que se van a consultar.

Valor Description
all

La ejecución se publica para cualquier contexto.
build

La ejecución se publica para el contexto de compilación.
release

La ejecución se publica para el contexto de versión.

TestRunState

Enumeración
Valor Description
aborted

La ejecución se detiene y se anulan las pruebas restantes.
completed

Todas las pruebas se han completado o se han omitido.
inProgress

Se están ejecutando pruebas.
needsInvestigation

La ejecución requiere investigación debido a un error de punto de prueba: se trata de un estado heredado y no se debe usar más.
notStarted

La ejecución todavía se está creando. Todavía no se han iniciado pruebas.
unspecified

Solo se usa durante una actualización para conservar el valor existente.
waiting

La ejecución está inicializando actualmente Este es un estado heredado y no debe usarse más

TestRunSubstate

Enumeración

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

Valor Description
abortedBySystem

Estado de ejecución cuando se anula por el sistema.
analyzed

Estado de ejecución después de analizarse.
canceledByUser

Estado de ejecución durante la creación del entorno.
cancellationInProgress

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

Estado de ejecución durante la creación del entorno.
none

Ejecute con noState.
pendingAnalysis

Estado de ejecución mientras se realiza el análisis pendiente.
runningTests

Estado de ejecución mientras se ejecutan pruebas.
timedOut

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

TestTag

Object

Etiqueta asociada a una ejecución o resultado.

Nombre Tipo Description
name

string

Nombre de la etiqueta, valor alfanumérico menor que 30 caracteres