Timeline - Get

Dienst:

Build

API-Version:

7.1-preview.2

Ruft Details für einen Build ab.

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

Mit optionalen Parametern:

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

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-preview.2" 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	Ermöglicht den Zugriff auf Buildartefakte, einschließlich Buildergebnissen, Definitionen und Anforderungen, sowie die Möglichkeit, Benachrichtigungen über Buildereignisse über Diensthooks 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-Verweislinks darstellt.
TaskReference	Stellt einen Verweis auf eine Aufgabe dar.
TaskResult	Das Ergebnis.
Timeline	Stellt die Zeitleiste eines Builds dar.
TimelineAttempt
TimelineRecord	Stellt einen Eintrag im Zeitleiste eines Builds dar.
TimelineRecordState	Der Status des Datensatzes.
TimelineReference	Stellt einen Verweis auf eine Zeitleiste dar.

BuildLogReference

Objekt

Stellt einen Verweis auf ein Buildprotokoll dar.

Name	Typ	Beschreibung
id	integer	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-Verweislinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützter Sind, möchten wir sie nur als schreibgeschützter Link verfügbar machen.

TaskReference

Objekt

Stellt einen Verweis auf eine Aufgabe dar.

Name	Typ	Beschreibung
id	string	Die ID der Aufgabendefinition.
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 Zeitleiste eines Builds dar.

Name	Typ	Beschreibung
changeId	integer	Die Änderungs-ID.
id	string	Die ID des Zeitleiste.
lastChangedBy	string	Der Prozess oder die Person, die den Zeitleiste zuletzt geändert hat.
lastChangedOn	string	Der Zeitpunkt, zu dem die Zeitleiste zuletzt geändert wurde.
records	TimelineRecord[]	Stellt einen Eintrag im Zeitleiste eines Builds dar.
url	string	Die REST-URL des Zeitleiste.

TimelineAttempt

Objekt

Name	Typ	Beschreibung
attempt	integer	Ruft den Versuch des Datensatzes ab oder legt ihn fest.
recordId	string	Ruft den Datensatzbezeichner ab, der sich innerhalb der angegebenen Zeitleiste befindet, oder legt diese fest.
timelineId	string	Ruft den Zeitleiste Bezeichner ab, der besitzer des Datensatzes ist, der diesen Versuch darstellt, oder legt diesen fest.

TimelineRecord

Objekt

Stellt einen Eintrag im Zeitleiste eines Builds dar.

Name	Typ	Beschreibung
_links	ReferenceLinks	Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.
attempt	integer	Anzahl des Datensatzversuchs.
changeId	integer	Die Änderungs-ID.
currentOperation	string	Eine Zeichenfolge, die den aktuellen Vorgang angibt.
details	TimelineReference	Ein Verweis auf einen untergeordneten Zeitleiste.
errorCount	integer	Die Anzahl der Fehler, die von diesem Vorgang erzeugt werden.
finishTime	string	Die Endzeit.
id	string	Die ID des Datensatzes.
identifier	string	Zeichenfolgenbezeichner, der bei allen Versuchen konsistent ist.
issues	Issue[]	Stellt ein Problem (Fehler, Warnung) dar, das einem Build zugeordnet ist.
lastModified	string	Der Zeitpunkt der letzten Änderung des Datensatzes.
log	BuildLogReference	Ein Verweis auf das Protokoll, das von diesem Vorgang erstellt wird.
name	string	Der Name.
order	integer	Ein Ordinalwert relativ zu anderen Datensätzen.
parentId	string	Die ID des übergeordneten Datensatzes.
percentComplete	integer	Der aktuelle Vervollständigungsprozentsatz.
previousAttempts	TimelineAttempt[]
queueId	integer	Die Warteschlangen-ID der Warteschlange, in der der Vorgang ausgeführt wurde.
result	TaskResult	Das Ergebnis.
resultCode	string	Der Ergebniscode.
startTime	string	Die Startzeit.
state	TimelineRecordState	Der Status des Datensatzes.
task	TaskReference	Ein Verweis auf die Aufgabe, die durch diesen Zeitleiste-Datensatz dargestellt wird.
type	string	Der Typ des Datensatzes.
url	string	Die REST-URL des Zeitleiste Datensatzes.
warningCount	integer	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 Zeitleiste dar.

Name	Typ	Beschreibung
changeId	integer	Die Änderungs-ID.
id	string	Die ID des Zeitleiste.
url	string	Die REST-URL des Zeitleiste.