Runs - Query

Service:

Test

API Version:

7.1-preview.3

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

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

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