共用方式為


Timeline - Get

取得組建的詳細資料

GET https://dev.azure.com/{organization}/{project}/_apis/build/builds/{buildId}/timeline/{timelineId}?api-version=7.1-preview.2
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

表示 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。