Runs - Get Test Run By Id

Referência

Service:: Test

API Version:: 7.1-preview.3

Obtenha uma execução de teste por sua ID.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
organization	path	True	string	O nome da organização do Azure DevOps.
project	path	True	string	ID do projeto ou nome do projeto
runId	path	True	integer int32	ID da execução a ser obtido.
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1-preview.3' para usar essa versão da API.
includeDetails	query		boolean	O valor padrão é true. Ele inclui detalhes como estatísticas de execução, versão, build, ambiente de teste, estado pós-processo e muito mais.

Respostas

Nome	Tipo	Description
200 OK	TestRun	operação bem-sucedida

Segurança

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

Nome	Description
vso.test	Concede a capacidade de ler planos de teste, casos, resultados e outros artefatos relacionados ao gerenciamento de testes.

Exemplos

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
}

Definições

Nome	Description
BuildConfiguration	Detalhes de BuildConfiguration.
CustomTestField	Informações de campo personalizadas. Chave permitida: pares de valor – ( AttemptId: int value, IsTestResultFlaky: bool)
DtlEnvironmentDetails	Essa é uma classe temporária para fornecer os detalhes do ambiente de execução de teste.
IdentityRef
JobReference	Trabalho no pipeline. Isso está relacionado à matriz no YAML.
PhaseReference	Fase no pipeline
PipelineReference	Referência de pipeline
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
ReleaseReference	Referência a uma versão.
ResultMetadata	ResultMetadata para o resultado/contagem determinado.
RunFilter	Essa classe é usada para fornecer os filtros usados para descoberta
RunStatistic	Estatísticas de execução de teste por resultado.
ShallowReference	Uma referência abstrata a algum outro recurso. Essa classe é usada para fornecer os contratos de dados de build com uma maneira uniforme de referenciar outros recursos de uma maneira que fornece fácil passagem por meio de links.
StageReference	Estágio no pipeline
TestEnvironment	Detalhes do ambiente de teste.
TestResolutionState	Detalhes do Estado de Resolução de Teste.
TestRun	Detalhes da execução de teste.
TestRunSubstate	Os tipos de sub-estados para execução de teste.
TestTag	Marca anexada a uma execução ou resultado.

BuildConfiguration

Detalhes de BuildConfiguration.

Nome	Tipo	Description
branchName	string	Nome do branch para o qual o build é gerado.
buildDefinitionId	integer	BuildDefinitionId para build.
buildSystem	string	Sistema de build.
creationDate	string	Data de criação do build.
flavor	string	Sabor de build (por exemplo, Build/Versão).
id	integer	ID de BuildConfiguration.
number	string	Número de build.
platform	string	Plataforma BuildConfiguration.
project	ShallowReference	Projeto associado a este BuildConfiguration.
repositoryGuid	string	Guid do repositório para o Build.
repositoryType	string	Tipo de repositório (por exemplo, TFSGit).
sourceVersion	string	A versão de origem (/primeira confirmação) para o build foi disparada.
targetBranchName	string	BranchName de destino.
uri	string	Uri de build.

CustomTestField

Informações de campo personalizadas. Chave permitida: pares de valor – ( AttemptId: int value, IsTestResultFlaky: bool)

Nome	Tipo	Description
fieldName	string	Nome do campo.
value	object	Valor do campo.

DtlEnvironmentDetails

Essa é uma classe temporária para fornecer os detalhes do ambiente de execução de teste.

Nome	Tipo	Description
csmContent	string
csmParameters	string
subscriptionName	string

IdentityRef

Nome	Tipo	Description
_links	ReferenceLinks	Esse campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.
descriptor	string	O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto do grafo entre contas e organizações.
directoryAlias	string	Preterido – pode ser recuperado consultando o usuário do Graph referenciado na entrada "self" do dicionário "_links" identityRef
displayName	string	Este é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.
id	string
imageUrl	string	Preterido - Disponível na entrada "avatar" do dicionário "_links" IdentityRef
inactive	boolean	Preterido – pode ser recuperado consultando o estado de associação do Graph referenciado na entrada "membershipState" do dicionário "_links" do GraphUser
isAadIdentity	boolean	Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Preterido – não em uso na maioria das implementações preexistidas de ToIdentityRef
uniqueName	string	Preterido – use Domain+PrincipalName
url	string	Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

JobReference

Trabalho no pipeline. Isso está relacionado à matriz no YAML.

Nome	Tipo	Description
attempt	integer	Número da tentativa do trabalho
jobName	string	A matriz no YAML gera cópias de um trabalho com entradas diferentes na matriz. JobName é o nome dessas entradas. O comprimento máximo com suporte para o nome é de 256 caracteres.

PhaseReference

Fase no pipeline

Nome	Tipo	Description
attempt	integer	Número da tentativa da fase
phaseName	string	Nome da fase. O comprimento máximo com suporte para o nome é de 256 caracteres.

PipelineReference

Referência de pipeline

Nome	Tipo	Description
jobReference	JobReference	Referência do trabalho
phaseReference	PhaseReference	Referência da fase.
pipelineId	integer	Referência do pipeline com o qual essa instância de pipeline está relacionada.
stageReference	StageReference	Referência do estágio.

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

ReleaseReference

Referência a uma versão.

Nome	Tipo	Description
attempt	integer	Número de tentativas de versão.
creationDate	string	Data de criação da versão (UTC).
definitionId	integer	ID da definição da versão.
environmentCreationDate	string	Data de criação do ambiente (UTC).
environmentDefinitionId	integer	ID da definição do ambiente de versão.
environmentDefinitionName	string	Nome da definição do ambiente de versão.
environmentId	integer	ID do ambiente de versão.
environmentName	string	Nome do ambiente de versão.
id	integer	ID da versão.
name	string	Nome da versão.

ResultMetadata

ResultMetadata para o resultado/contagem determinado.

Nome	Tipo	Description
flaky	string	Metadados irregulares
rerun	string	Executar metadados novamente

RunFilter

Essa classe é usada para fornecer os filtros usados para descoberta

Nome	Tipo	Description
sourceFilter	string	filtro para as fontes de caso de teste (contêineres de teste)
testCaseFilter	string	filtrar para os casos de teste

RunStatistic

Estatísticas de execução de teste por resultado.

Nome	Tipo	Description
count	integer	Contagem de resultados de teste para o resultado especificado.
outcome	string	Resultado do teste
resolutionState	TestResolutionState	Estado de Resolução da execução de teste.
resultMetadata	ResultMetadata	ResultMetadata para o resultado/contagem determinado.
state	string	Estado da execução de teste

ShallowReference

Uma referência abstrata a algum outro recurso. Essa classe é usada para fornecer os contratos de dados de build com uma maneira uniforme de referenciar outros recursos de uma maneira que fornece fácil passagem por meio de links.

Nome	Tipo	Description
id	string	ID do recurso
name	string	Nome do recurso vinculado (nome da definição, nome do controlador etc.)
url	string	Link http completo para o recurso

StageReference

Estágio no pipeline

Nome	Tipo	Description
attempt	integer	Número de tentativas de estágio
stageName	string	Nome do estágio. O comprimento máximo com suporte para o nome é de 256 caracteres.

TestEnvironment

Detalhes do ambiente de teste.

Nome	Tipo	Description
environmentId	string	ID do ambiente de teste.
environmentName	string	Nome do ambiente de teste.

TestResolutionState

Detalhes do Estado de Resolução de Teste.

Nome	Tipo	Description
id	integer	ID do estado da Resolução de Teste.
name	string	Nome do Estado de Resolução de Teste.
project	ShallowReference	Uma referência abstrata a algum outro recurso. Essa classe é usada para fornecer os contratos de dados de build com uma maneira uniforme de referenciar outros recursos de uma maneira que fornece fácil passagem por meio de links.

TestRun

Detalhes da execução de teste.

Nome	Tipo	Description
build	ShallowReference	Build associado a esta execução de teste.
buildConfiguration	BuildConfiguration	Detalhes de configuração de build associados a essa execução de teste.
comment	string	Comentários inseridos por aqueles que analisam a execução.
completedDate	string	Data e hora da execução concluídas.
controller	string	Test Run Controller.
createdDate	string	Execução de teste CreatedDate.
customFields	CustomTestField[]	Lista de campos personalizados para TestRun.
dropLocation	string	Local de remoção para a execução de teste.
dtlAutEnvironment	ShallowReference	Uma referência abstrata a algum outro recurso. Essa classe é usada para fornecer os contratos de dados de build com uma maneira uniforme de referenciar outros recursos de uma maneira que fornece fácil passagem por meio de links.
dtlEnvironment	ShallowReference	Uma referência abstrata a algum outro recurso. Essa classe é usada para fornecer os contratos de dados de build com uma maneira uniforme de referenciar outros recursos de uma maneira que fornece fácil passagem por meio de links.
dtlEnvironmentCreationDetails	DtlEnvironmentDetails	Essa é uma classe temporária para fornecer os detalhes do ambiente de execução de teste.
dueDate	string	Data e hora de conclusão da execução do teste.
errorMessage	string	Mensagem de erro associada à execução.
filter	RunFilter	Essa classe é usada para fornecer os filtros usados para descoberta
id	integer	ID da execução do teste.
incompleteTests	integer	Número de testes incompletos.
isAutomated	boolean	true se a execução de teste for automatizada; caso contrário, false.
iteration	string	A iteração à qual a execução pertence.
lastUpdatedBy	IdentityRef	ID de base da equipe da última atualização da execução do teste.
lastUpdatedDate	string	Data e hora da última atualização
name	string	Nome da execução de teste.
notApplicableTests	integer	Número de testes não aplicáveis.
owner	IdentityRef	ID do Team Foundation do proprietário das execuções.
passedTests	integer	Número de testes aprovados na execução
phase	string	Fase/Estado do testRun.
pipelineReference	PipelineReference	Referência do pipeline ao qual esta execução de teste pertence.
plan	ShallowReference	Plano de teste associado a esta execução de teste.
postProcessState	string	Estado pós-processo.
project	ShallowReference	Projeto associado a essa execução.
release	ReleaseReference	Referência de versão para a execução de teste.
releaseEnvironmentUri	string	URI do ambiente de versão para TestRun.
releaseUri	string	URI de versão para TestRun.
revision	integer
runStatistics	RunStatistic[]	RunSummary por resultado.
startedDate	string	Data de início da execução.
state	string	O estado da execução. Tipo TestRunState Estados válidos – Não especificado , NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate	TestRunSubstate	Subestado TestRun.
tags	TestTag[]	Marcas anexadas com esta execução de teste.
testEnvironment	TestEnvironment	Ambiente de teste associado à execução.
testMessageLogId	integer
testSettings	ShallowReference	Uma referência abstrata a algum outro recurso. Essa classe é usada para fornecer os contratos de dados de build com uma maneira uniforme de referenciar outros recursos de uma maneira que fornece fácil passagem por meio de links.
totalTests	integer	Total de testes na execução
unanalyzedTests	integer	Número de testes com falha na execução.
url	string	URL da execução de teste
webAccessUrl	string	URL de Acesso à Web para TestRun.

TestRunSubstate

Os tipos de sub-estados para execução de teste.

Nome	Tipo	Description
abortedBySystem	string	Execute o estado quando for Anulado pelo Sistema.
analyzed	string	Estado de execução após ser analisado.
canceledByUser	string	Estado de execução ao criar ambiente.
cancellationInProgress	string	Execute o estado quando o cancelamento estiver em andamento.
creatingEnvironment	string	Estado de execução ao criar ambiente.
none	string	Execute com noState.
pendingAnalysis	string	Execute o estado durante a Análise Pendente.
runningTests	string	Execute o estado durante a execução de testes.
timedOut	string	Execute o estado quando a execução tiver timedOut.

TestTag

Marca anexada a uma execução ou resultado.

Nome	Tipo	Description
name	string	Nome da marca, valor alfanumérico menor que 30 caracteres

Compartilhar via