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

名稱	位於	必要	類型	Description
buildId	path	True	integer int32
organization	path	True	string	Azure DevOps 組織的名稱。
project	path	True	string	專案識別碼或專案名稱
timelineId	path		string uuid
api-version	query	True	string	要使用的 API 版本。 這應該設定為 '7.1-preview.2'，以使用此版本的 API。
changeId	query		integer int32
planId	query		string uuid

回應

名稱	類型	Description
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

名稱	Description
vso.build	授與存取組建成品的能力，包括建置結果、定義和要求，以及能夠透過服務勾點接收有關建置事件的通知。

定義

名稱	Description
BuildLogReference	表示組建記錄檔的參考。
Issue	表示與組建相關聯的問題 (錯誤、警告) 。
IssueType	(錯誤、警告) 問題類型。
ReferenceLinks	表示 REST 參考連結集合的類別。
TaskReference	表示工作的參考。
TaskResult	結果。
Timeline	表示組建的時間軸。
TimelineAttempt
TimelineRecord	表示組建時程表中的專案。
TimelineRecordState	記錄的狀態。
TimelineReference	表示時間軸的參考。

BuildLogReference

表示組建記錄檔的參考。

名稱	類型	Description
id	integer	記錄檔的識別碼。
type	string	記錄位置的類型。
url	string	記錄資源的完整連結。

Issue

表示與組建相關聯的問題 (錯誤、警告) 。

名稱	類型	Description
category	string	類別目錄。
data	object
message	string	問題的描述。
type	IssueType	(錯誤、警告) 問題類型。

IssueType

(錯誤、警告) 問題類型。

名稱	類型	Description
error	string
warning	string

ReferenceLinks

表示 REST 參考連結集合的類別。

名稱	類型	Description
links	object	連結的唯讀檢視。 因為參考連結是唯讀的，所以我們只想要將它們公開為唯讀。

TaskReference

表示工作的參考。

名稱	類型	Description
id	string	工作定義的識別碼。
name	string	工作定義的名稱。
version	string	工作定義的版本。

TaskResult

結果。

名稱	類型	Description
abandoned	string
canceled	string
failed	string
skipped	string
succeeded	string
succeededWithIssues	string

Timeline

表示組建的時間軸。

名稱	類型	Description
changeId	integer	變更識別碼。
id	string	時程表的識別碼。
lastChangedBy	string	上次變更時程表的程式或人員。
lastChangedOn	string	時間軸上次變更的時間。
records	TimelineRecord[]	表示組建時程表中的專案。
url	string	時程表的 REST URL。

TimelineAttempt

名稱	類型	Description
attempt	integer	取得或設定記錄的嘗試。
recordId	string	取得或設定位於指定時間軸內的記錄識別碼。
timelineId	string	取得或設定擁有代表此嘗試之記錄的時程表識別碼。

TimelineRecord

表示組建時程表中的專案。

名稱	類型	Description
_links	ReferenceLinks	表示 REST 參考連結集合的類別。
attempt	integer	嘗試記錄數目。
changeId	integer	變更識別碼。
currentOperation	string	表示目前作業的字串。
details	TimelineReference	子時間軸的參考。
errorCount	integer	這項作業所產生的錯誤數目。
finishTime	string	完成時間。
id	string	記錄的識別碼。
identifier	string	嘗試之間一致的字串識別碼。
issues	Issue[]	表示與組建相關聯的問題 (錯誤、警告) 。
lastModified	string	上次修改記錄的時間。
log	BuildLogReference	這個作業所產生之記錄的參考。
name	string	名稱。
order	integer	相對於其他記錄的序數值。
parentId	string	記錄父系的識別碼。
percentComplete	integer	目前的完成百分比。
previousAttempts	TimelineAttempt[]
queueId	integer	作業執行之佇列的佇列識別碼。
result	TaskResult	結果。
resultCode	string	結果碼。
startTime	string	開始時間。
state	TimelineRecordState	記錄的狀態。
task	TaskReference	此時程表記錄所代表之工作的參考。
type	string	記錄的類型。
url	string	時程表記錄的 REST URL。
warningCount	integer	這項作業所產生的警告數目。
workerName	string	執行作業的代理程式名稱。

TimelineRecordState

記錄的狀態。

名稱	類型	Description
completed	string
inProgress	string
pending	string

TimelineReference

表示時間軸的參考。

名稱	類型	Description
changeId	integer	變更識別碼。
id	string	時程表的識別碼。
url	string	時程表的 REST URL。