Resultsummarybybuild - Query

服务:

Test Results

API 版本:

7.1-preview.1

GET https://vstmr.dev.azure.com/{organization}/{project}/_apis/testresults/resultsummarybybuild?buildId={buildId}&api-version=7.1-preview.1

具有可选参数:

GET https://vstmr.dev.azure.com/{organization}/{project}/_apis/testresults/resultsummarybybuild?buildId={buildId}&publishContext={publishContext}&includeFailureDetails={includeFailureDetails}&buildToCompare.branchName={buildToCompare.branchName}&buildToCompare.buildSystem={buildToCompare.buildSystem}&buildToCompare.definitionId={buildToCompare.definitionId}&buildToCompare.id={buildToCompare.id}&buildToCompare.number={buildToCompare.number}&buildToCompare.repositoryId={buildToCompare.repositoryId}&buildToCompare.uri={buildToCompare.uri}&api-version=7.1-preview.1

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
project	path	True	string	项目 ID 或项目名称
api-version	query	True	string	要使用的 API 版本。 这应设置为“7.1-preview.1”才能使用此版本的 API。
buildId	query	True	integer int32
buildToCompare.branchName	query		string	分支名称。
buildToCompare.buildSystem	query		string	生成系统。
buildToCompare.definitionId	query		integer int32	生成定义 ID。
buildToCompare.id	query		integer int32	生成 ID。
buildToCompare.number	query		string	Build 号。
buildToCompare.repositoryId	query		string	存储库 ID。
buildToCompare.uri	query		string	生成 URI。
includeFailureDetails	query		boolean
publishContext	query		string

响应

名称	类型	说明
200 OK	TestResultSummary	成功的操作

安全性

oauth2

类型: oauth2
流向: accessCode
授权 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 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

作用域

名称	说明
vso.test	授予读取测试计划、事例、结果和其他测试管理相关项目的能力。

定义

名称	说明
AggregatedResultsAnalysis
AggregatedResultsByOutcome
AggregatedResultsDifference
AggregatedRunsByOutcome
AggregatedRunsByState
BuildReference	对生成的引用。
JobReference	管道中的作业。 这与 YAML 中的矩阵相关。
PhaseReference	阶段在管道中
PipelineReference	管道参考
ProjectState
ProjectVisibility
ReleaseReference	对发布的引用。
StageReference	管道中的阶段
TeamProjectReference
TestCaseResultIdentifier	对测试结果的引用。
TestFailureDetails
TestFailuresAnalysis
TestOutcome
TestResultsContext
TestResultsContextType
TestResultSummary
TestRunOutcome
TestRunState

AggregatedResultsAnalysis

Object

名称	类型	说明
duration	string
notReportedResultsByOutcome	<string,  AggregatedResultsByOutcome>
previousContext	TestResultsContext
resultsByOutcome	<string,  AggregatedResultsByOutcome>
resultsDifference	AggregatedResultsDifference
runSummaryByOutcome	<string,  AggregatedRunsByOutcome>
runSummaryByState	<string,  AggregatedRunsByState>
totalTests	integer

AggregatedResultsByOutcome

Object

名称	类型	说明
count	integer
duration	string
groupByField	string
groupByValue	object
outcome	TestOutcome
rerunResultCount	integer

AggregatedResultsDifference

Object

名称	类型	说明
increaseInDuration	string
increaseInFailures	integer
increaseInNonImpactedTests	integer
increaseInOtherTests	integer
increaseInPassedTests	integer
increaseInTotalTests	integer

AggregatedRunsByOutcome

Object

名称	类型	说明
outcome	TestRunOutcome
runsCount	integer

AggregatedRunsByState

Object

名称	类型	说明
resultsByOutcome	<string,  AggregatedResultsByOutcome>
runsCount	integer
state	TestRunState

BuildReference

Object

对生成的引用。

名称	类型	说明
branchName	string	分支名称。
buildSystem	string	生成系统。
definitionId	integer	生成定义 ID。
id	integer	生成 ID。
number	string	Build 号。
repositoryId	string	存储库 ID。
uri	string	生成 URI。

JobReference

Object

管道中的作业。 这与 YAML 中的矩阵相关。

名称	类型	说明
attempt	integer	作业的尝试次数
jobName	string	YAML 中的矩阵在矩阵中生成具有不同输入的作业的副本。 JobName 是这些输入的名称。 名称支持的最大长度为 256 个字符。

PhaseReference

Object

阶段在管道中

名称	类型	说明
attempt	integer	阶段的尝试次数
phaseName	string	阶段的名称。 名称支持的最大长度为 256 个字符。

PipelineReference

Object

管道参考

名称	类型	说明
jobReference	JobReference	作业的引用
phaseReference	PhaseReference	阶段的引用。
pipelineId	integer	与此管道实例相关的管道的引用。
stageReference	StageReference	阶段的引用。

ProjectState

Enumeration

值	说明
all
createPending
deleted
deleting
new
unchanged
wellFormed

ProjectVisibility

Enumeration

值	说明
private
public

ReleaseReference

Object

对发布的引用。

名称	类型	说明
attempt	integer	发布尝试次数。
creationDate	string	发行创建日期 (UTC) 。
definitionId	integer	发布定义 ID。
environmentCreationDate	string	环境创建日期 (UTC) 。
environmentDefinitionId	integer	发布环境定义 ID。
environmentDefinitionName	string	发布环境定义名称。
environmentId	integer	发布环境 ID。
environmentName	string	发布环境名称。
id	integer	版本 ID。
name	string	版本名称。

StageReference

Object

管道中的阶段

名称	类型	说明
attempt	integer	阶段尝试次数
stageName	string	阶段的名称。 名称支持的最大长度为 256 个字符。

TeamProjectReference

Object

名称	类型	说明
abbreviation	string
defaultTeamImageUrl	string
description	string
id	string
lastUpdateTime	string
name	string
revision	integer
state	ProjectState
url	string
visibility	ProjectVisibility

TestCaseResultIdentifier

Object

对测试结果的引用。

名称	类型	说明
testResultId	integer	测试结果 ID。
testRunId	integer	测试运行 ID。

TestFailureDetails

Object

名称	类型	说明
count	integer
testResults	TestCaseResultIdentifier[]	对测试结果的引用。

TestFailuresAnalysis

Object

名称	类型	说明
existingFailures	TestFailureDetails
fixedTests	TestFailureDetails
newFailures	TestFailureDetails
previousContext	TestResultsContext

TestOutcome

Enumeration

值	说明
aborted	测试已中止。 这不是由用户手势引起的，而是由框架决策引起的。
blocked	测试有机会执行，但不是，因为 ITestElement.IsRunnable == false。
error	尝试执行测试时出现系统错误。
failed	测试已执行，但存在问题。 问题可能涉及异常或失败的断言。
inProgress	测试当前正在执行。 为中医图表添加了此图表
inconclusive	测试已完成，但无法说明测试是通过还是失败。 可用于中止的测试...
none	测试尚未完成，或者测试类型未报告通过/失败。
notApplicable	测试不适用于执行。
notExecuted	测试未执行。 这是由用户手势（例如用户点击停止按钮）引起的。
notImpacted	测试不受影响。 添加了 fot TIA。
passed	执行了测试，但存在任何问题。
paused	测试已暂停。
timeout	测试超时
unspecified	仅在更新期间使用以保留现有值。
warning	由运行级别结果使用。 这不是失败。

TestResultsContext

Object

名称	类型	说明
build	BuildReference	对生成的引用。
contextType	TestResultsContextType
pipelineReference	PipelineReference	管道参考
release	ReleaseReference	对发布的引用。

TestResultsContextType

Enumeration

值	说明
build
pipeline
release

TestResultSummary

Object

名称	类型	说明
aggregatedResultsAnalysis	AggregatedResultsAnalysis
noConfigRunsCount	integer
teamProject	TeamProjectReference
testFailures	TestFailuresAnalysis
testResultsContext	TestResultsContext
totalRunsCount	integer

TestRunOutcome

Enumeration

值	说明
failed	运行至少一个失败的测试。
notImpacted	在没有受影响的测试的情况下运行。
others	与其他类别中的所有测试一起运行。
passed	运行时没有失败的测试，并且至少有一个受影响的测试

TestRunState

Enumeration

值	说明
aborted	运行已停止，剩余测试已中止
completed	所有测试都已完成或已跳过。
inProgress	测试正在运行。
needsInvestigation	由于测试点失败，运行需要调查 这是旧状态，不应再使用
notStarted	仍在创建运行。 尚未开始任何测试。
unspecified	仅在更新期间使用以保留现有值。
waiting	运行当前正在初始化 这是旧状态，不应再使用