Timeline - Get

Service:

Build

API Version:

7.1-preview.2

获取生成的详细信息

GET https://dev.azure.com/{organization}/{project}/_apis/build/builds/{buildId}/timeline/{timelineId}?api-version=7.1-preview.2

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/build/builds/{buildId}/timeline/{timelineId}?changeId={changeId}&planId={planId}&api-version=7.1-preview.2

URI 参数

名称	在	必需	类型	说明
buildId	path	True	integer int32
organization	path	True	string	Azure DevOps 组织的名称。
project	path	True	string	项目 ID 或项目名称
timelineId	path		string uuid
api-version	query	True	string	要使用的 API 版本。 应将其设置为“7.1-preview.2”才能使用此版本的 API。
changeId	query		integer int32
planId	query		string uuid

响应

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

安全性

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

名称	说明
vso.build	授予访问生成项目（包括生成结果、定义和请求）以及通过服务挂钩接收有关生成事件的通知的能力。

定义

名称	说明
BuildLogReference	表示对生成日志的引用。
Issue	表示与生成关联的问题 (错误、警告) 。
IssueType	类型 (错误、警告) 问题。
ReferenceLinks	表示 REST 引用链接集合的类。
TaskReference	表示对任务的引用。
TaskResult	结果。
Timeline	表示生成的时间线。
TimelineAttempt
TimelineRecord	表示生成时间线中的条目。
TimelineRecordState	记录的状态。
TimelineReference	表示对时间线的引用。

BuildLogReference

表示对生成日志的引用。

名称	类型	说明
id	integer	日志的 ID。
type	string	日志位置的类型。
url	string	指向日志资源的完整链接。

Issue

表示与生成关联的问题 (错误、警告) 。

名称	类型	说明
category	string	类别。
data	object
message	string	问题的说明。
type	IssueType	类型 (错误、警告) 问题。

IssueType

类型 (错误、警告) 问题。

名称	类型	说明
error	string
warning	string

ReferenceLinks

表示 REST 引用链接集合的类。

名称	类型	说明
links	object	链接的只读视图。 由于引用链接是只读的，因此我们只想将其公开为只读。

TaskReference

表示对任务的引用。

名称	类型	说明
id	string	任务定义的 ID。
name	string	任务定义的名称。
version	string	任务定义的版本。

TaskResult

结果。

名称	类型	说明
abandoned	string
canceled	string
failed	string
skipped	string
succeeded	string
succeededWithIssues	string

Timeline

表示生成的时间线。

名称	类型	说明
changeId	integer	更改 ID。
id	string	时间线的 ID。
lastChangedBy	string	上次更改时间线的进程或人员。
lastChangedOn	string	上次更改时间线的时间。
records	TimelineRecord[]	表示生成时间线中的条目。
url	string	时间线的 REST URL。

TimelineAttempt

名称	类型	说明
attempt	integer	获取或设置记录的尝试。
recordId	string	获取或设置位于指定时间线内的记录标识符。
timelineId	string	获取或设置时间线标识符，该标识符拥有表示此尝试的记录。

TimelineRecord

表示生成时间线中的条目。

名称	类型	说明
_links	ReferenceLinks	表示 REST 引用链接集合的类。
attempt	integer	记录的尝试次数。
changeId	integer	更改 ID。
currentOperation	string	指示当前操作的字符串。
details	TimelineReference	对子时间线的引用。
errorCount	integer	此操作生成的错误数。
finishTime	string	完成时间。
id	string	记录的 ID。
identifier	string	在尝试中保持一致的字符串标识符。
issues	Issue[]	表示与生成关联的问题 (错误、警告) 。
lastModified	string	上次修改记录的时间。
log	BuildLogReference	对此操作生成的日志的引用。
name	string	名称。
order	integer	相对于其他记录的序号值。
parentId	string	记录的父级的 ID。
percentComplete	integer	当前完成百分比。
previousAttempts	TimelineAttempt[]
queueId	integer	运行操作的队列的队列 ID。
result	TaskResult	结果。
resultCode	string	结果代码。
startTime	string	开始时间。
state	TimelineRecordState	记录的状态。
task	TaskReference	对此时间线记录表示的任务的引用。
type	string	记录的类型。
url	string	时间线记录的 REST URL。
warningCount	integer	此操作生成的警告数。
workerName	string	运行操作的代理的名称。

TimelineRecordState

记录的状态。

名称	类型	说明
completed	string
inProgress	string
pending	string

TimelineReference

表示对时间线的引用。

名称	类型	说明
changeId	integer	更改 ID。
id	string	时间线的 ID。
url	string	时间线的 REST URL。