Timeline - Get

Service:

Build

Version d'API:

7.1

Obtient les détails d’une build

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

Avec des paramètres facultatifs:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
buildId	path	True	integer (int32)
organization	path	True	string	Nom de l’organisation Azure DevOps.
project	path	True	string	ID de projet ou nom du projet
timelineId	path		string (uuid)
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1 » pour utiliser cette version de l’API.
changeId	query		integer (int32)
planId	query		string (uuid)

Réponses

Nom	Type	Description
200 OK	Timeline	opération réussie

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom	Description
vso.build	Accorde la possibilité d’accéder aux artefacts de build, notamment les résultats de build, les définitions et les demandes, et la possibilité de recevoir des notifications sur les événements de génération via des hooks de service.

Définitions

Nom	Description
BuildLogReference	Représente une référence à un journal de génération.
Issue	Représente un problème (erreur, avertissement) associé à une build.
IssueType	Type (erreur, avertissement) du problème.
ReferenceLinks	Classe à représenter une collection de liens de référence REST.
TaskReference	Représente une référence à une tâche.
TaskResult	Résultat.
Timeline	Représente la chronologie d’une build.
TimelineAttempt
TimelineRecord	Représente une entrée dans la chronologie d’une build.
TimelineRecordState	État de l’enregistrement.
TimelineReference	Représente une référence à une chronologie.

BuildLogReference

Object

Représente une référence à un journal de génération.

Nom	Type	Description
id	integer (int32)	ID du journal.
type	string	Type de l’emplacement du journal.
url	string	Lien complet vers la ressource de journal.

Issue

Object

Représente un problème (erreur, avertissement) associé à une build.

Nom	Type	Description
category	string	Catégorie.
data	object
message	string	Description du problème.
type	IssueType	Type (erreur, avertissement) du problème.

IssueType

Énumération

Type (erreur, avertissement) du problème.

Valeur	Description
error
warning

ReferenceLinks

Object

Classe à représenter une collection de liens de référence REST.

Nom	Type	Description
links	object	Vue en lecture seule des liens. Étant donné que les liens de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

TaskReference

Object

Représente une référence à une tâche.

Nom	Type	Description
id	string (uuid)	ID de la définition de tâche.
name	string	Nom de la définition de tâche.
version	string	Version de la définition de tâche.

TaskResult

Énumération

Résultat.

Valeur	Description
abandoned
canceled
failed
skipped
succeeded
succeededWithIssues

Timeline

Object

Représente la chronologie d’une build.

Nom	Type	Description
changeId	integer (int32)	ID de modification.
id	string (uuid)	ID de la chronologie.
lastChangedBy	string (uuid)	Processus ou personne qui a modifié la chronologie pour la dernière fois.
lastChangedOn	string (date-time)	Heure de la dernière modification de la chronologie.
records	TimelineRecord[]	Représente une entrée dans la chronologie d’une build.
url	string	URL REST de la chronologie.

TimelineAttempt

Object

Nom	Type	Description
attempt	integer (int32)	Obtient ou définit la tentative d’enregistrement.
recordId	string (uuid)	Obtient ou définit l’identificateur d’enregistrement situé dans la chronologie spécifiée.
timelineId	string (uuid)	Obtient ou définit l’identificateur de chronologie qui possède l’enregistrement représentant cette tentative.

TimelineRecord

Object

Représente une entrée dans la chronologie d’une build.

Nom	Type	Description
_links	ReferenceLinks	Classe à représenter une collection de liens de référence REST.
attempt	integer (int32)	Essayez le nombre d’enregistrements.
changeId	integer (int32)	ID de modification.
currentOperation	string	Chaîne qui indique l’opération actuelle.
details	TimelineReference	Référence à une sous-chronologie.
errorCount	integer (int32)	Nombre d’erreurs produites par cette opération.
finishTime	string (date-time)	Heure de fin.
id	string (uuid)	ID de l’enregistrement.
identifier	string	Identificateur de chaîne cohérent entre les tentatives.
issues	Issue[]	Représente un problème (erreur, avertissement) associé à une build.
lastModified	string (date-time)	Heure de la dernière modification de l’enregistrement.
log	BuildLogReference	Référence au journal généré par cette opération.
name	string	Nom.
order	integer (int32)	Valeur ordinale par rapport à d’autres enregistrements.
parentId	string (uuid)	ID du parent de l’enregistrement.
percentComplete	integer (int32)	Pourcentage d’achèvement actuel.
previousAttempts	TimelineAttempt[]
queueId	integer (int32)	ID de file d’attente de la file d’attente sur laquelle l’opération s’est exécutée.
result	TaskResult	Résultat.
resultCode	string	Code de résultat.
startTime	string (date-time)	Heure de début.
state	TimelineRecordState	État de l’enregistrement.
task	TaskReference	Référence à la tâche représentée par cet enregistrement de chronologie.
type	string	Type de l’enregistrement.
url	string	URL REST de l’enregistrement de chronologie.
warningCount	integer (int32)	Nombre d’avertissements générés par cette opération.
workerName	string	Nom de l’agent exécutant l’opération.

TimelineRecordState

Énumération

État de l’enregistrement.

Valeur	Description
completed
inProgress
pending

TimelineReference

Object

Représente une référence à une chronologie.

Nom	Type	Description
changeId	integer (int32)	ID de modification.
id	string (uuid)	ID de la chronologie.
url	string	URL REST de la chronologie.