Runs - Create

Referência

Service:: Test

API Version:: 7.1-preview.3

Crie uma nova execução de teste.

POST https://dev.azure.com/{organization}/{project}/_apis/test/runs?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.

Corpo da solicitação

Nome	Tipo	Description
automated	boolean	true se a execução de teste for automatizada, caso contrário, false. Por padrão, será false.
build	ShallowReference	Uma referência abstrata ao build que ele pertence.
buildDropLocation	string	Remova o local do build usado para execução de teste.
buildFlavor	string	Sabor do build usado para execução de teste. (Por exemplo: Versão, Depuração)
buildPlatform	string	Plataforma do build usado para execução de teste. (Por exemplo: x86, amd64)
buildReference	BuildConfiguration	BuildReference da execução do teste.
comment	string	Comentários inseridos por aqueles que analisam a execução.
completeDate	string	Data de data concluída da execução.
configurationIds	integer[]	IDs das configurações de teste associadas à execução.
controller	string	Nome do controlador de teste usado para execução automatizada.
customTestFields	CustomTestField[]	Propriedades adicionais da execução de teste.
dtlAutEnvironment	ShallowReference	Uma referência abstraída a DtlAutEnvironment.
dtlTestEnvironment	ShallowReference	Uma referência abstraida a DtlTestEnvironment.
dueDate	string	Data e hora de conclusão da execução do teste.
environmentDetails	DtlEnvironmentDetails	Essa é uma classe temporária para fornecer os detalhes do ambiente de execução de teste.
errorMessage	string	Mensagem de erro associada à execução.
filter	RunFilter	Filtro usado para descobrir a Execução.
iteration	string	A iteração na qual criar a execução. A iteração raiz do projeto de equipe será padrão
name	string	Nome da execução de teste.
owner	IdentityRef	Nome de exibição do proprietário da execução.
pipelineReference	PipelineReference	Referência do pipeline ao qual esta execução de teste pertence. PipelineReference.PipelineId deve ser igual a RunCreateModel.Build.Id
plan	ShallowReference	Uma referência abstraida ao plano que ele pertence.
pointIds	integer[]	IDs dos pontos de teste a serem usados na execução.
releaseEnvironmentUri	string	URI do ambiente de versão associado à execução.
releaseReference	ReleaseReference	Referência à versão associada à execução de teste.
releaseUri	string	URI da versão associada à execução.
runSummary	RunSummaryModel[]	Executar resumo para executar Tipo = NoConfigRun.
runTimeout	string	Tempo limite até o tempo limite de execução.
sourceWorkflow	string	SourceWorkFlow(CI/CD) da execução do teste.
startDate	string	Data de início da execução.
state	string	O estado da execução. Tipo TestRunState Estados válidos – NotStarted, InProgress, Waiting
tags	TestTag[]	Marcas a serem anexadas com a execução de teste, no máximo 5 marcas podem ser adicionadas para execução.
testConfigurationsMapping	string	TestConfigurationMapping da execução do teste.
testEnvironmentId	string	ID do ambiente de teste associado à execução.
testSettings	ShallowReference	Uma referência abstraida ao recurso de configurações de teste.
type	string	Tipo dos valores válidos run(RunType): (Não especificado, normal, bloqueado, Web, MtrRunInitiatedFromWeb, RunWithDtlEnv, NoConfigRun)

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_write	Concede a capacidade de ler, criar e atualizar planos de teste, casos, resultados e outros artefatos relacionados ao gerenciamento de testes.

Exemplos

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/runs?api-version=7.1-preview.3

{
  "name": "NewTestRun",
  "plan": {
    "id": "1"
  },
  "pointIds": [
    1,
    1
  ]
}

Sample Response

Status code:: 200

{
  "id": 31,
  "name": "NewTestRun",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Runs/31",
  "isAutomated": false,
  "iteration": "Fabrikam-Fiber-TFVC\\Release 1\\Sprint 1",
  "owner": {
    "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabrikamfiber3@hotmail.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
  },
  "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-28T16:39:00.44Z",
  "state": "InProgress",
  "plan": {
    "id": "1",
    "name": "sprint1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
  },
  "postProcessState": "Complete",
  "totalTests": 2,
  "incompleteTests": 2,
  "createdDate": "2014-05-28T16:39:00.4Z",
  "lastUpdatedDate": "2014-05-28T16:39:00.44Z",
  "lastUpdatedBy": {
    "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabrikamfiber3@hotmail.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
  },
  "revision": 2
}

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 especificado.
RunCreateModel	Detalhes de criação da execução de teste.
RunFilter	Essa classe é usada para fornecer os filtros usados para descoberta
RunStatistic	Estatísticas de execução de teste por resultado.
RunSummaryModel	Execute o resumo para cada tipo de saída 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.
StageReference	Estágio no pipeline
TestEnvironment	Detalhes do ambiente de teste.
TestOutcome
TestResolutionState	Detalhes do estado de resolução de teste.
TestRun	Detalhes da execução do 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	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 de 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	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 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 de versão.
environmentCreationDate	string	Data de criação do ambiente (UTC).
environmentDefinitionId	integer	ID de 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 especificado.

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

RunCreateModel

Detalhes de criação da execução de teste.

Nome	Tipo	Description
automated	boolean	true se a execução de teste for automatizada; caso contrário, false. Por padrão, será false.
build	ShallowReference	Uma referência abstrata ao build ao qual ele pertence.
buildDropLocation	string	Local de remoção do build usado para execução de teste.
buildFlavor	string	Sabor do build usado para execução de teste. (Por exemplo: Versão, Depuração)
buildPlatform	string	Plataforma do build usado para execução de teste. (Por exemplo: x86, amd64)
buildReference	BuildConfiguration	BuildReference da execução de teste.
comment	string	Comentários inseridos por aqueles que analisam a execução.
completeDate	string	Data e hora da execução concluídas.
configurationIds	integer[]	IDs das configurações de teste associadas à execução.
controller	string	Nome do controlador de teste usado para execução automatizada.
customTestFields	CustomTestField[]	Propriedades adicionais da execução de teste.
dtlAutEnvironment	ShallowReference	Uma referência abstraída a DtlAutEnvironment.
dtlTestEnvironment	ShallowReference	Uma referência abstrata a DtlTestEnvironment.
dueDate	string	Data e hora de conclusão da execução do teste.
environmentDetails	DtlEnvironmentDetails	Essa é uma classe temporária para fornecer os detalhes do ambiente de execução de teste.
errorMessage	string	Mensagem de erro associada à execução.
filter	RunFilter	Filtro usado para descobrir a Execução.
iteration	string	A iteração na qual a execução será criada. A iteração raiz do projeto de equipe será padrão
name	string	Nome da execução de teste.
owner	IdentityRef	Nome de exibição do proprietário da execução.
pipelineReference	PipelineReference	Referência do pipeline ao qual esta execução de teste pertence. PipelineReference.PipelineId deve ser igual a RunCreateModel.Build.Id
plan	ShallowReference	Uma referência abstrata ao plano ao qual ele pertence.
pointIds	integer[]	IDs dos pontos de teste a serem usados na execução.
releaseEnvironmentUri	string	URI do ambiente de versão associado à execução.
releaseReference	ReleaseReference	Referência à versão associada à execução de teste.
releaseUri	string	URI da versão associada à execução.
runSummary	RunSummaryModel[]	Resumo da execução de Tipo = NoConfigRun.
runTimeout	string	Tempo limite até o tempo limite da execução.
sourceWorkflow	string	SourceWorkFlow(CI/CD) da execução de teste.
startDate	string	Data de início da execução.
state	string	O estado da execução. Tipo TestRunState Estados válidos - NotStarted, InProgress, Waiting
tags	TestTag[]	Marcas a serem anexadas com a execução de teste, no máximo 5 marcas podem ser adicionadas para execução.
testConfigurationsMapping	string	TestConfigurationMapping da execução do teste.
testEnvironmentId	string	ID do ambiente de teste associado à execução.
testSettings	ShallowReference	Uma referência abstrata ao recurso de configurações de teste.
type	string	Tipo dos valores válidos run(RunType): (Unspecified, Normal, Blocking, Web, MtrRunInitiatedFromWeb, RunWithDtlEnv, NoConfigRun)

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

RunSummaryModel

Execute o resumo para cada tipo de saída de teste.

Nome	Tipo	Description
duration	integer	Tempo total gasto em milissegundos.
resultCount	integer	Número de resultados para TestOutcome de Resultado
testOutcome	TestOutcome	O resumo é baseado no 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.

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.

TestOutcome

Nome	Tipo	Description
aborted	string	O teste foi anulado. Isso não foi causado por um gesto do usuário, mas sim por uma decisão de estrutura.
blocked	string	O teste teve a chance de ser executado, mas não foi, como ITestElement.IsRunnable == false.
error	string	Ocorreu um erro do sistema enquanto estávamos tentando executar um teste.
failed	string	O teste foi executado, mas houve problemas. Os problemas podem envolver exceções ou declarações com falha.
inProgress	string	O teste está em execução no momento. Adição disso para gráficos TCM
inconclusive	string	O teste foi concluído, mas não podemos dizer se ele foi aprovado ou falhou. Pode ser usado para testes anulados...
none	string	O teste não foi concluído ou o tipo de teste não relata aprovação/falha.
notApplicable	string	O teste não é aplicável para execução.
notExecuted	string	O teste não foi executado. Isso foi causado por um gesto do usuário , por exemplo, botão de parada de clique do usuário.
notImpacted	string	O teste não é afetado. Adição de fot TIA.
passed	string	O teste foi executado com todos os problemas.
paused	string	O teste está em pausa.
timeout	string	O teste atingiu o tempo limite
unspecified	string	Usado somente durante uma atualização para preservar o valor existente.
warning	string	Para ser usado pelos resultados de nível de execução. Isso não é uma falha.

TestResolutionState

Detalhes do estado de resolução de teste.

Nome	Tipo	Description
id	integer	Testar a ID do estado da Resolução.
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

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. 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	Execute o estado após ser analisado.
canceledByUser	string	Execute o estado durante a criação do ambiente.
cancellationInProgress	string	Execute o estado quando o cancelamento estiver em andamento.
creatingEnvironment	string	Execute o estado durante a criação do 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 tempo limite.

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