Runs - Query

Service:

Test

API Version:

7.1-preview.3

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

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
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.
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 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 (obligatoria).
$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 haya creado (o modificado, 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

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.

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.
TestRunPublishContext	PublishContext de las ejecuciones que se van a consultar.
TestRunState
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 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

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

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 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" 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.

ReferenceLinks

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 versión.
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 los que analizan la ejecución.
completedDate	string	Fecha 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	Quitar 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 prueba.
incompleteTests	integer	Número de pruebas incompletas.
isAutomated	boolean	True si la ejecución de pruebas está automatizada; en caso contrario, false.
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	Fecha y hora actualizadas por última vez
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 prueba.
postProcessState	string	Estado del proceso posterior.
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 de inicio de la ejecución.
state	string	Estado de la ejecución. Escriba TestRunState Estados válidos: Unspecified ,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
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 errores en la ejecución.
url	string	Dirección URL de la ejecución de prueba
webAccessUrl	string	Dirección URL de acceso web para TestRun.

TestRunPublishContext

PublishContext de las ejecuciones que se van a consultar.

Nombre	Tipo	Description
all	string	La ejecución se publica para cualquier contexto.
build	string	La ejecución se publica para el contexto de compilación.
release	string	La ejecución se publica para el contexto de versión.

TestRunState

Nombre	Tipo	Description
aborted	string	La ejecución se detiene y se han anulado las pruebas restantes.
completed	string	Todas las pruebas se han completado o se han omitido.
inProgress	string	Las pruebas se están ejecutando.
needsInvestigation	string	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	string	La ejecución todavía se está creando. Todavía no se han iniciado pruebas.
unspecified	string	Solo se usa durante una actualización para conservar el valor existente.
waiting	string	Ejecutar está inicializando actualmente Este es un estado heredado y no se debe usar más

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