Timeline - Get

Dienst:

Build

API-Version:

7.1

Ruft Details für einen Build ab

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
buildId	path	True	integer (int32)
organization	path	True	string	Der Name der Azure DevOps-Organisation.
project	path	True	string	Projekt-ID oder Projektname
timelineId	path		string (uuid)
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.
changeId	query		integer (int32)
planId	query		string (uuid)

Antworten

Name	Typ	Beschreibung
200 OK	Timeline	Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-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

Bereiche

Name	Beschreibung
vso.build	Gewährt die Möglichkeit, auf Buildartefakte zuzugreifen, einschließlich Buildergebnissen, Definitionen und Anforderungen sowie die Möglichkeit, Benachrichtigungen über Buildereignisse über Dienst-Hooks zu empfangen.

Definitionen

Name	Beschreibung
BuildLogReference	Stellt einen Verweis auf ein Buildprotokoll dar.
Issue	Stellt ein Problem (Fehler, Warnung) dar, das einem Build zugeordnet ist.
IssueType	Der Typ (Fehler, Warnung) des Problems.
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.
TaskReference	Stellt einen Verweis auf eine Aufgabe dar.
TaskResult	Das Ergebnis.
Timeline	Stellt die Zeitachse eines Builds dar.
TimelineAttempt
TimelineRecord	Stellt einen Eintrag in der Zeitachse eines Builds dar.
TimelineRecordState	Der Status des Datensatzes.
TimelineReference	Stellt einen Verweis auf eine Zeitachse dar.

BuildLogReference

Objekt

Stellt einen Verweis auf ein Buildprotokoll dar.

Name	Typ	Beschreibung
id	integer (int32)	Die ID des Protokolls.
type	string	Der Typ des Protokollspeicherorts.
url	string	Ein vollständiger Link zur Protokollressource.

Issue

Objekt

Stellt ein Problem (Fehler, Warnung) dar, das einem Build zugeordnet ist.

Name	Typ	Beschreibung
category	string	Die Kategorie.
data	object
message	string	Eine Beschreibung des Problems.
type	IssueType	Der Typ (Fehler, Warnung) des Problems.

IssueType

Enumeration

Der Typ (Fehler, Warnung) des Problems.

Wert	Beschreibung
error
warning

ReferenceLinks

Objekt

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Referenzlinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

TaskReference

Objekt

Stellt einen Verweis auf eine Aufgabe dar.

Name	Typ	Beschreibung
id	string (uuid)	Die ID der Vorgangsdefinition.
name	string	Der Name der Aufgabendefinition.
version	string	Die Version der Aufgabendefinition.

TaskResult

Enumeration

Das Ergebnis.

Wert	Beschreibung
abandoned
canceled
failed
skipped
succeeded
succeededWithIssues

Timeline

Objekt

Stellt die Zeitachse eines Builds dar.

Name	Typ	Beschreibung
changeId	integer (int32)	Die Änderungs-ID.
id	string (uuid)	Die ID der Zeitachse.
lastChangedBy	string (uuid)	Der Prozess oder die Person, der die Zeitachse zuletzt geändert hat.
lastChangedOn	string (date-time)	Der Zeitpunkt, zu dem die Zeitachse zuletzt geändert wurde.
records	TimelineRecord[]	Stellt einen Eintrag in der Zeitachse eines Builds dar.
url	string	Die REST-URL der Zeitachse.

TimelineAttempt

Objekt

Name	Typ	Beschreibung
attempt	integer (int32)	Ruft den Versuch des Datensatzes ab oder legt den Versuch fest.
recordId	string (uuid)	Dient zum Abrufen oder Festlegen des Datensatzbezeichners innerhalb der angegebenen Zeitachse.
timelineId	string (uuid)	Ruft den Zeitachsenbezeichner ab, der den Datensatz besitzt, der diesen Versuch darstellt, oder legt diesen fest.

TimelineRecord

Objekt

Stellt einen Eintrag in der Zeitachse eines Builds dar.

Name	Typ	Beschreibung
_links	ReferenceLinks	Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.
attempt	integer (int32)	Versuchsnummer des Datensatzes.
changeId	integer (int32)	Die Änderungs-ID.
currentOperation	string	Eine Zeichenfolge, die den aktuellen Vorgang angibt.
details	TimelineReference	Ein Verweis auf eine Unterzeitachse.
errorCount	integer (int32)	Die Anzahl der von diesem Vorgang erzeugten Fehler.
finishTime	string (date-time)	Die Endzeit.
id	string (uuid)	Die ID des Datensatzes.
identifier	string	Zeichenfolgenbezeichner, der über Versuche hinweg konsistent ist.
issues	Issue[]	Stellt ein Problem (Fehler, Warnung) dar, das einem Build zugeordnet ist.
lastModified	string (date-time)	Der Zeitpunkt, zu dem der Datensatz zuletzt geändert wurde.
log	BuildLogReference	Ein Verweis auf das von diesem Vorgang erstellte Protokoll.
name	string	Der Name.
order	integer (int32)	Ein Ordinalwert relativ zu anderen Datensätzen.
parentId	string (uuid)	Die ID des übergeordneten Datensatzes.
percentComplete	integer (int32)	Der aktuelle Fertigstellungsprozentsatz.
previousAttempts	TimelineAttempt[]
queueId	integer (int32)	Die Warteschlangen-ID der Warteschlange, auf der der Vorgang ausgeführt wurde.
result	TaskResult	Das Ergebnis.
resultCode	string	Der Ergebniscode.
startTime	string (date-time)	Die Startzeit.
state	TimelineRecordState	Der Status des Datensatzes.
task	TaskReference	Ein Verweis auf die Aufgabe, die durch diesen Zeitachsendatensatz dargestellt wird.
type	string	Der Typ des Datensatzes.
url	string	Die REST-URL des Zeitachsendatensatzes.
warningCount	integer (int32)	Die Anzahl der Warnungen, die von diesem Vorgang erzeugt werden.
workerName	string	Der Name des Agents, der den Vorgang ausführt.

TimelineRecordState

Enumeration

Der Status des Datensatzes.

Wert	Beschreibung
completed
inProgress
pending

TimelineReference

Objekt

Stellt einen Verweis auf eine Zeitachse dar.

Name	Typ	Beschreibung
changeId	integer (int32)	Die Änderungs-ID.
id	string (uuid)	Die ID der Zeitachse.
url	string	Die REST-URL der Zeitachse.