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 |
run
|
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. |
include
|
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 |
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 |
---|---|
Build |
Detalles de BuildConfiguration. |
Custom |
Información de campo personalizada. Clave permitida: pares de valor - ( AttemptId: int value, IsTestResultFlaky: bool) |
Dtl |
Se trata de una clase temporal para proporcionar los detalles del entorno de ejecución de pruebas. |
Identity |
|
Job |
Trabajo en canalización. Esto está relacionado con la matriz en YAML. |
Phase |
Fase en la canalización |
Pipeline |
Referencia de canalización |
Reference |
Clase que se va a representar una colección de vínculos de referencia de REST. |
Release |
Referencia a una versión. |
Result |
ResultMetadata para el resultado o recuento especificados. |
Run |
Esta clase se usa para proporcionar los filtros usados para la detección. |
Run |
Estadísticas de ejecución de pruebas por resultado. |
Shallow |
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. |
Stage |
Fase en la canalización |
Test |
Detalles del entorno de prueba. |
Test |
Detalles del estado de resolución de pruebas. |
Test |
Detalles de la ejecución de pruebas. |
Test |
Los tipos de sub estados para la ejecución de pruebas. |
Test |
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 |
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 |
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 |
Referencia del trabajo |
|
phaseReference |
Referencia de la fase. |
|
pipelineId |
integer |
Referencia de la canalización con la que está relacionada esta instancia de canalización. |
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 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 |
Estado de resolución de ejecución de prueba. |
|
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 |
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 |
Compilación asociada a esta ejecución de prueba. |
|
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 |
Lista de campos personalizados para TestRun. |
|
dropLocation |
string |
Coloque ubicación para la ejecución de prueba. |
dtlAutEnvironment |
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 |
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 |
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 |
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 |
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 |
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 |
Referencia de la canalización a la que pertenece esta ejecución de prueba. |
|
plan |
Plan de pruebas asociado a esta ejecución de pruebas. |
|
postProcessState |
string |
Estado posterior al proceso. |
project |
Proyecto asociado a esta ejecución. |
|
release |
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 |
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 |
TestRun Substate(Ejecutar subestado). |
|
tags |
Test |
Etiquetas asociadas a esta ejecución de prueba. |
testEnvironment |
Entorno de prueba asociado a la ejecución. |
|
testMessageLogId |
integer |
|
testSettings |
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 |