Partilhar via

Runs - Query

  • Referência
Serviço:
Test
Versão da API:
7.1

Execuções de teste de consulta com base em filtros. Os campos obrigatórios são minLastUpdatedDate e maxLastUpdatedDate.

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

string

Versão da API a ser usada. Isso deve ser definido como '7.1' para usar essa versão da api.
maxLastUpdatedDate
 query True

string (date-time)

Data máxima da última modificação da execução a ser consultada (obrigatório, a diferença entre a data mínima e a máxima pode ser de no máximo 7 dias).
minLastUpdatedDate
 query True

string (date-time)

Data mínima da última modificação da execução a ser consultada (obrigatório).
$top
 query

integer (int32)

Número de execuções a serem consultadas. O limite é 100
branchName
 query

string

Nome do Branch de Origem das Execuções a serem consultadas.
buildDefIds
 query

string (array (int32))

IDs de definição de build das execuções a serem consultadas, lista separada por vírgulas de IDs válidas (limite nº de IDs 10).
buildIds
 query

string (array (int32))

IDs de build das Execuções a serem consultadas, lista separada por vírgulas de IDs válidas (limite nº de IDs 10).
continuationToken
 query

string

continuationToken recebido do lote anterior ou nulo para o primeiro lote. Ele não deve ser criado (ou alterado, se recebido do último lote) pelo usuário.
isAutomated
 query

boolean

Tipo de automação das Execuções a serem consultadas.
planIds
 query

string (array (int32))

Planejar IDs das Execuções a serem consultadas, lista separada por vírgulas de IDs válidas (limite nº de IDs 10).
publishContext
 query

TestRunPublishContext

PublishContext das Execuções a serem consultadas.
releaseDefIds
 query

string (array (int32))

IDs de definição de versão das Execuções a serem consultadas, lista separada por vírgulas de IDs válidas (limite nº de IDs 10).
releaseEnvDefIds
 query

string (array (int32))

IDs de definição de ambiente de versão das execuções a serem consultadas, lista separada por vírgulas de IDs válidas (limite nº de IDs 10).
releaseEnvIds
 query

string (array (int32))

IDs de ambiente de versão das execuções a serem consultadas, lista separada por vírgulas de IDs válidas (limite nº de IDs 10).
releaseIds
 query

string (array (int32))

IDs de versão das Execuções a serem consultadas, lista separada por vírgulas de IDs válidas (limite nº de IDs 10).
runTitle
 query

string

Execute o título das execuções a serem consultadas.
state
 query

TestRunState

Estado atual das Execuções a serem consultadas.

Respostas

Nome Tipo Description
200 OK

TestRun[]

operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do 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

Escopos

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

Definições

Nome Description
BuildConfiguration

Detalhes de BuildConfiguration.
CustomTestField

Informações de campo personalizadas. Chave Permitida: Pares de valor - ( AttemptId: valor int, 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 especificado.
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 abstraida 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 da resolução de teste.
TestRun

Detalhes da execução do teste.
TestRunPublishContext

PublishContext das Execuções a serem consultadas.
TestRunState
TestRunSubstate

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

Marca anexada a uma execução ou resultado.

BuildConfiguration

Objeto

Detalhes de BuildConfiguration.

Nome Tipo Description
branchName

string

Nome do branch para o qual o build é gerado.
buildDefinitionId

integer (int32)

BuildDefinitionId para build.
buildSystem

string

Sistema de build.
creationDate

string (date-time)

Data de criação do build.
flavor

string

Sabor de build (por exemplo, Build/Release).
id

integer (int32)

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

Compilar Uri.

CustomTestField

Objeto

Informações de campo personalizadas. Chave Permitida: Pares de valor - ( AttemptId: valor int, IsTestResultFlaky: bool)

Nome Tipo Description
fieldName

string

Nome do campo.
value

object

Valor do campo.

DtlEnvironmentDetails

Objeto

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

Objeto
Nome Tipo Description
_links

ReferenceLinks

Este 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 de grafo em 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

Esse é 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" do 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 adiado 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 pré-existentes de ToIdentityRef
uniqueName

string

Preterido – use Domain+PrincipalName em vez disso
url

string

Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

JobReference

Objeto

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

Nome Tipo Description
attempt

integer (int32)

Número de 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

Objeto

Fase no pipeline

Nome Tipo Description
attempt

integer (int32)

Número da tentativa da fase
phaseName

string

Nome da fase. O comprimento máximo com suporte para o nome é de 256 caracteres.

PipelineReference

Objeto

Referência de pipeline

Nome Tipo Description
jobReference

JobReference

Referência do trabalho
phaseReference

PhaseReference

Referência da fase.
pipelineId

integer (int32)

Referência do pipeline com o qual essa instância de pipeline está relacionada.
stageReference

StageReference

Referência do estágio.
Objeto

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

Objeto

Referência a uma versão.

Nome Tipo Description
attempt

integer (int32)

Número de tentativas de versão.
creationDate

string (date-time)

Data de Criação da Versão (UTC).
definitionId

integer (int32)

ID de definição de versão.
environmentCreationDate

string (date-time)

Data de criação do ambiente (UTC).
environmentDefinitionId

integer (int32)

ID da definição do ambiente de versão.
environmentDefinitionName

string

Nome da definição do ambiente de versão.
environmentId

integer (int32)

ID do ambiente de versão.
environmentName

string

Nome do ambiente de versão.
id

integer (int32)

ID da versão.
name

string

Nome da versão.

ResultMetadata

Enumeração

ResultMetadata para o resultado/contagem especificado.

Valor Description
flaky

Metadados esfarrapados
rerun

Executar metadados novamente

RunFilter

Objeto

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

Objeto

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

Nome Tipo Description
count

integer (int32)

Contagem de resultados do teste para o resultado especificado.
outcome

string

Resultado do resultado do teste
resolutionState

TestResolutionState

Estado de Resolução da execução de teste.
resultMetadata

ResultMetadata

ResultMetadata para o resultado/contagem especificado.
state

string

Estado da execução do teste

ShallowReference

Objeto

Uma referência abstraida 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

Objeto

Estágio no pipeline

Nome Tipo Description
attempt

integer (int32)

Número de tentativa de estágio
stageName

string

Nome do estágio. O comprimento máximo com suporte para o nome é de 256 caracteres.

TestEnvironment

Objeto

Detalhes do ambiente de teste.

Nome Tipo Description
environmentId

string (uuid)

ID do ambiente de teste.
environmentName

string

Nome do ambiente de teste.

TestResolutionState

Objeto

Detalhes do estado da resolução de teste.

Nome Tipo Description
id

integer (int32)

ID do estado da Resolução de Teste.
name

string

Nome do estado da resolução de teste.
project

ShallowReference

Uma referência abstraida 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

Objeto

Detalhes da execução do teste.

Nome Tipo Description
build

ShallowReference

Compilação associada a essa 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 (date-time)

Data/hora concluída da execução.
controller

string

Controlador de execução de teste.
createdDate

string (date-time)

Execução de teste CreatedDate.
customFields

CustomTestField[]

Lista de campos personalizados para TestRun.
dropLocation

string

Drop Location for the test Run.
dtlAutEnvironment

ShallowReference

Uma referência abstraida 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 abstraida 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 (date-time)

Data e hora de conclusã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 (int32)

ID da execução do teste.
incompleteTests

integer (int32)

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 da base de equipe da última atualização da execução do teste.
lastUpdatedDate

string (date-time)

Data e hora da última atualização
name

string

Nome da execução de teste.
notApplicableTests

integer (int32)

Número de testes não aplicáveis.
owner

IdentityRef

ID do Team Foundation do proprietário das execuções.
passedTests

integer (int32)

Número de testes aprovados na execução
phase

string

Fase/Estado para o testRun.
pipelineReference

PipelineReference

Referência do pipeline ao qual essa execução de teste pertence.
plan

ShallowReference

Plano de teste associado a essa 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 (int32)

runStatistics

RunStatistic[]

RunSummary por resultado.
startedDate

string (date-time)

Data de início da execução.
state

string

O estado da execução. Type TestRunState Valid states - Unspecified ,NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate

TestRunSubstate

Subestado TestRun.
tags

TestTag[]

Marcas anexadas a essa execução de teste.
testEnvironment

TestEnvironment

Ambiente de teste associado à execução.
testMessageLogId

integer (int32)

testSettings

ShallowReference

Uma referência abstraida 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 (int32)

Total de testes na execução
unanalyzedTests

integer (int32)

Número de testes com falha na execução.
url

string

URL da execução do teste
webAccessUrl

string

Url de Acesso à Web para TestRun.

TestRunPublishContext

Enumeração

PublishContext das Execuções a serem consultadas.

Valor Description
all

A execução é publicada para qualquer Contexto.
build

A execução é publicada para o Contexto de Build.
release

A execução é publicada para o Contexto de Versão.

TestRunState

Enumeração
Valor Description
aborted

A execução foi interrompida e os testes restantes foram anulados
completed

Todos os testes foram concluídos ou ignorados.
inProgress

Os testes estão em execução.
needsInvestigation

Executar requer investigação devido a uma falha de ponto de teste Este é um estado herdado e não deve ser mais usado
notStarted

A execução ainda está sendo criada. Nenhum teste foi iniciado ainda.
unspecified

Usado somente durante uma atualização para preservar o valor existente.
waiting

A execução está inicializando no momento esse é um estado herdado e não deve ser mais usado

TestRunSubstate

Enumeração

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

Valor Description
abortedBySystem

Execute o estado quando for abortado pelo sistema.
analyzed

Execute o estado após ser analisado.
canceledByUser

Execute o estado durante a criação do ambiente.
cancellationInProgress

Execute o estado quando o cancelamento estiver em andamento.
creatingEnvironment

Execute o estado durante a criação do ambiente.
none

Execute com noState.
pendingAnalysis

Executar o estado durante a Análise Pendente.
runningTests

Execute o estado durante a execução de testes.
timedOut

Execute o estado quando a execução tiver tempo limite.

TestTag

Objeto

Marca anexada a uma execução ou resultado.

Nome Tipo Description
name

string

Nome da marca, valor alfanumérico menor que 30 caracteres