Timeline - Get

Usługa:

Build

Wersja interfejsu API:

7.1

Pobiera szczegóły kompilacji

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
buildId	path	True	integer (int32)
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
project	path	True	string	Identyfikator projektu lub nazwa projektu
timelineId	path		string (uuid)
api-version	query	True	string	Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API.
changeId	query		integer (int32)
planId	query		string (uuid)

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Timeline	operacja zakończona powodzeniem

Zabezpieczenia

oauth2

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

Zakresy

Nazwa	Opis
vso.build	Umożliwia dostęp do artefaktów kompilacji, w tym wyników kompilacji, definicji i żądań oraz możliwość odbierania powiadomień o zdarzeniach kompilacji za pośrednictwem punktów zaczepienia usługi.

Definicje

Nazwa	Opis
BuildLogReference	Reprezentuje odwołanie do dziennika kompilacji.
Issue	Reprezentuje problem (błąd, ostrzeżenie) skojarzony z kompilacją.
IssueType	Typ (błąd, ostrzeżenie) problemu.
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
TaskReference	Reprezentuje odwołanie do zadania.
TaskResult	Wynik.
Timeline	Reprezentuje oś czasu kompilacji.
TimelineAttempt
TimelineRecord	Reprezentuje wpis na osi czasu kompilacji.
TimelineRecordState	Stan rekordu.
TimelineReference	Reprezentuje odwołanie do osi czasu.

BuildLogReference

Objekt

Reprezentuje odwołanie do dziennika kompilacji.

Nazwa	Typ	Opis
id	integer (int32)	Identyfikator dziennika.
type	string	Typ lokalizacji dziennika.
url	string	Pełny link do zasobu dziennika.

Issue

Objekt

Reprezentuje problem (błąd, ostrzeżenie) skojarzony z kompilacją.

Nazwa	Typ	Opis
category	string	Kategoria.
data	object
message	string	Opis problemu.
type	IssueType	Typ (błąd, ostrzeżenie) problemu.

IssueType

Wyliczanie

Typ (błąd, ostrzeżenie) problemu.

Wartość	Opis
error
warning

ReferenceLinks

Objekt

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Czytelny widok linków. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

TaskReference

Objekt

Reprezentuje odwołanie do zadania.

Nazwa	Typ	Opis
id	string (uuid)	Identyfikator definicji zadania.
name	string	Nazwa definicji zadania.
version	string	Wersja definicji zadania.

TaskResult

Wyliczanie

Wynik.

Wartość	Opis
abandoned
canceled
failed
skipped
succeeded
succeededWithIssues

Timeline

Objekt

Reprezentuje oś czasu kompilacji.

Nazwa	Typ	Opis
changeId	integer (int32)	Identyfikator zmiany.
id	string (uuid)	Identyfikator osi czasu.
lastChangedBy	string (uuid)	Proces lub osoba, która ostatnio zmieniła oś czasu.
lastChangedOn	string (date-time)	Czas ostatniej zmiany osi czasu.
records	TimelineRecord[]	Reprezentuje wpis na osi czasu kompilacji.
url	string	Adres URL REST osi czasu.

TimelineAttempt

Objekt

Nazwa	Typ	Opis
attempt	integer (int32)	Pobiera lub ustawia próbę rekordu.
recordId	string (uuid)	Pobiera lub ustawia identyfikator rekordu znajdujący się na określonej osi czasu.
timelineId	string (uuid)	Pobiera lub ustawia identyfikator osi czasu, który jest właścicielem rekordu reprezentującego tę próbę.

TimelineRecord

Objekt

Reprezentuje wpis na osi czasu kompilacji.

Nazwa	Typ	Opis
_links	ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
attempt	integer (int32)	Liczba prób rekordu.
changeId	integer (int32)	Identyfikator zmiany.
currentOperation	string	Ciąg wskazujący bieżącą operację.
details	TimelineReference	Odwołanie do pod osi czasu.
errorCount	integer (int32)	Liczba błędów generowanych przez tę operację.
finishTime	string (date-time)	Godzina zakończenia.
id	string (uuid)	Identyfikator rekordu.
identifier	string	Identyfikator ciągu, który jest spójny w różnych próbach.
issues	Issue[]	Reprezentuje problem (błąd, ostrzeżenie) skojarzony z kompilacją.
lastModified	string (date-time)	Godzina ostatniej modyfikacji rekordu.
log	BuildLogReference	Odwołanie do dziennika wygenerowanego przez tę operację.
name	string	Nazwa.
order	integer (int32)	Wartość porządkowa względem innych rekordów.
parentId	string (uuid)	Identyfikator elementu nadrzędnego rekordu.
percentComplete	integer (int32)	Bieżąca wartość procentowa ukończenia.
previousAttempts	TimelineAttempt[]
queueId	integer (int32)	Identyfikator kolejki kolejki uruchomionej przez operację.
result	TaskResult	Wynik.
resultCode	string	Kod wyniku.
startTime	string (date-time)	Godzina rozpoczęcia.
state	TimelineRecordState	Stan rekordu.
task	TaskReference	Odwołanie do zadania reprezentowanego przez ten rekord osi czasu.
type	string	Typ rekordu.
url	string	Adres URL REST rekordu osi czasu.
warningCount	integer (int32)	Liczba ostrzeżeń generowanych przez tę operację.
workerName	string	Nazwa agenta uruchamiającego operację.

TimelineRecordState

Wyliczanie

Stan rekordu.

Wartość	Opis
completed
inProgress
pending

TimelineReference

Objekt

Reprezentuje odwołanie do osi czasu.

Nazwa	Typ	Opis
changeId	integer (int32)	Identyfikator zmiany.
id	string (uuid)	Identyfikator osi czasu.
url	string	Adres URL REST osi czasu.