Freigeben über


Timeline - Get

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
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

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

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

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

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

Der Typ (Fehler, Warnung) des Problems.

Name Typ Beschreibung
error

string

warning

string

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

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

Das Ergebnis.

Name Typ Beschreibung
abandoned

string

canceled

string

failed

string

skipped

string

succeeded

string

succeededWithIssues

string

Timeline

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

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

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

Der Status des Datensatzes.

Name Typ Beschreibung
completed

string

inProgress

string

pending

string

TimelineReference

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.