Compartilhar via


Runs - Query

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-preview.3
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 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-preview.3' 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 data mínima e 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)

Release Environment Ids of the Runs to be queried, comma separated list of valid ids (limit no. of 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

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.

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

Detalhes de BuildConfiguration.

Nome Tipo Description
branchName

string

Nome do branch para o qual o build é gerado.

buildDefinitionId

integer

BuildDefinitionId para build.

buildSystem

string

Criar sistema.

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

BuildConfiguration Platform.

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 (/primeiro commit) para o build foi disparada.

targetBranchName

string

BranchName de destino.

uri

string

Compilar Uri.

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 IdentityRef "_links"

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 IdentityRef "_links"

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

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.

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

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 do teste.

Nome Tipo Description
build

ShallowReference

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

Data de data concluída da execução.

controller

string

Controlador de Execução de Teste.

createdDate

string

Test Run CreatedDate.

customFields

CustomTestField[]

Lista de campos personalizados para TestRun.

dropLocation

string

Remover Local para a execução de teste.

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

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

A ID do Team Foundation 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 para o testRun.

pipelineReference

PipelineReference

Referência do pipeline ao qual esta 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

Versão Uri 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. Type TestRunState Valid states - Unspecified ,NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation

substate

TestRunSubstate

TestRun Substate.

tags

TestTag[]

Marcas anexadas com essa execução de teste.

testEnvironment

TestEnvironment

Ambiente de teste associado à execução.

testMessageLogId

integer

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

Total de testes na execução

unanalyzedTests

integer

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

PublishContext das Execuções a serem consultadas.

Nome Tipo Description
all

string

A execução é publicada para qualquer Contexto.

build

string

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

release

string

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

TestRunState

Nome Tipo Description
aborted

string

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

completed

string

Todos os testes foram concluídos ou ignorados.

inProgress

string

Os testes estão em execução.

needsInvestigation

string

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

notStarted

string

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

unspecified

string

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

waiting

string

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

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