Timeline - Get

Služba:

Build

Verze rozhraní API:

7.1

Získá podrobnosti o sestavení.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
buildId	path	True	integer (int32)
organization	path	True	string	Název organizace Azure DevOps.
project	path	True	string	ID projektu nebo název projektu
timelineId	path		string (uuid)
api-version	query	True	string	Verze rozhraní API, která se má použít. Pokud chcete použít tuto verzi rozhraní API, měla by být nastavená na hodnotu 7.1.
changeId	query		integer (int32)
planId	query		string (uuid)

Odpovědi

Name	Typ	Description
200 OK	Timeline	úspěšná operace

Zabezpečení

oauth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL tokenu: 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

Rozsahy

Name	Description
vso.build	Uděluje možnost přístupu k artefaktům sestavení, včetně výsledků sestavení, definic a požadavků, a možnost přijímat oznámení o událostech sestavení prostřednictvím volání služby.

Definice

Name	Description
BuildLogReference	Představuje odkaz na protokol sestavení.
Issue	Představuje problém (chyba, upozornění) přidružený k sestavení.
IssueType	Typ problému (chyba, upozornění)
ReferenceLinks	Třída představující kolekci odkazů REST.
TaskReference	Představuje odkaz na úkol.
TaskResult	Výsledek.
Timeline	Představuje časovou osu sestavení.
TimelineAttempt
TimelineRecord	Představuje položku na časové ose sestavení.
TimelineRecordState	Stav záznamu.
TimelineReference	Představuje odkaz na časovou osu.

BuildLogReference

Objekt

Představuje odkaz na protokol sestavení.

Name	Typ	Description
id	integer (int32)	ID protokolu.
type	string	Typ umístění protokolu.
url	string	Úplný odkaz na prostředek protokolu.

Issue

Objekt

Představuje problém (chyba, upozornění) přidružený k sestavení.

Name	Typ	Description
category	string	Kategorie.
data	object
message	string	Popis problému.
type	IssueType	Typ problému (chyba, upozornění)

IssueType

Výčet

Typ problému (chyba, upozornění)

Hodnota	Description
error
warning

ReferenceLinks

Objekt

Třída představující kolekci odkazů REST.

Name	Typ	Description
links	object	Jen pro čtení odkazů. Vzhledem k tomu, že odkazy odkazy jsou jen pro čtení, chceme je zveřejnit jen pro čtení.

TaskReference

Objekt

Představuje odkaz na úkol.

Name	Typ	Description
id	string (uuid)	ID definice úkolu.
name	string	Název definice úkolu.
version	string	Verze definice úlohy.

TaskResult

Výčet

Výsledek.

Hodnota	Description
abandoned
canceled
failed
skipped
succeeded
succeededWithIssues

Timeline

Objekt

Představuje časovou osu sestavení.

Name	Typ	Description
changeId	integer (int32)	ID změny.
id	string (uuid)	ID časové osy.
lastChangedBy	string (uuid)	Proces nebo osoba, která naposledy změnila časovou osu.
lastChangedOn	string (date-time)	Čas poslední změny časové osy
records	TimelineRecord[]	Představuje položku na časové ose sestavení.
url	string	Adresa URL REST časové osy.

TimelineAttempt

Objekt

Name	Typ	Description
attempt	integer (int32)	Získá nebo nastaví pokus o záznam.
recordId	string (uuid)	Získá nebo nastaví identifikátor záznamu umístěný v zadané časové ose.
timelineId	string (uuid)	Získá nebo nastaví identifikátor časové osy, který vlastní záznam představující tento pokus.

TimelineRecord

Objekt

Představuje položku na časové ose sestavení.

Name	Typ	Description
_links	ReferenceLinks	Třída představující kolekci odkazů REST.
attempt	integer (int32)	Počet pokusů o záznam.
changeId	integer (int32)	ID změny.
currentOperation	string	Řetězec, který označuje aktuální operaci.
details	TimelineReference	Odkaz na dílčí časovou osu.
errorCount	integer (int32)	Počet chyb vytvořených touto operací.
finishTime	string (date-time)	Čas dokončení.
id	string (uuid)	ID záznamu.
identifier	string	Identifikátor řetězce, který je konzistentní napříč pokusy.
issues	Issue[]	Představuje problém (chyba, upozornění) přidružený k sestavení.
lastModified	string (date-time)	Čas poslední změny záznamu.
log	BuildLogReference	Odkaz na protokol vytvořený touto operací.
name	string	Název.
order	integer (int32)	Pořadová hodnota relativní k jiným záznamům.
parentId	string (uuid)	ID nadřazeného záznamu.
percentComplete	integer (int32)	Aktuální procento dokončení
previousAttempts	TimelineAttempt[]
queueId	integer (int32)	ID fronty fronty, na které byla operace spuštěna.
result	TaskResult	Výsledek.
resultCode	string	Kód výsledku.
startTime	string (date-time)	Čas zahájení.
state	TimelineRecordState	Stav záznamu.
task	TaskReference	Odkaz na úkol reprezentovaný tímto záznamem časové osy
type	string	Typ záznamu.
url	string	Adresa URL REST záznamu časové osy.
warningCount	integer (int32)	Počet upozornění vytvořených touto operací.
workerName	string	Název agenta, na kterém je operace spuštěná.

TimelineRecordState

Výčet

Stav záznamu.

Hodnota	Description
completed
inProgress
pending

TimelineReference

Objekt

Představuje odkaz na časovou osu.

Name	Typ	Description
changeId	integer (int32)	ID změny.
id	string (uuid)	ID časové osy.
url	string	Adresa URL REST časové osy.