Timeline - Get

Servizio:

Build

Versione API:

7.1

Ottiene i dettagli per una compilazione

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
buildId	path	True	integer (int32)
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
project	path	True	string	ID progetto o nome progetto
timelineId	path		string (uuid)
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '7.1' per usare questa versione dell'API.
changeId	query		integer (int32)
planId	query		string (uuid)

Risposte

Nome	Tipo	Descrizione
200 OK	Timeline	operazione riuscita

Sicurezza

oauth2

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: 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

Ambiti

Nome	Descrizione
vso.build	Concede la possibilità di accedere agli artefatti di compilazione, inclusi i risultati di compilazione, le definizioni e le richieste e la possibilità di ricevere notifiche sugli eventi di compilazione tramite hook del servizio.

Definizioni

Nome	Descrizione
BuildLogReference	Rappresenta un riferimento a un log di compilazione.
Issue	Rappresenta un problema (errore, avviso) associato a una compilazione.
IssueType	Tipo (errore, avviso) del problema.
ReferenceLinks	Classe per rappresentare una raccolta di collegamenti di riferimento REST.
TaskReference	Rappresenta un riferimento a un'attività.
TaskResult	Il risultato.
Timeline	Rappresenta la sequenza temporale di una compilazione.
TimelineAttempt
TimelineRecord	Rappresenta una voce nella sequenza temporale di una compilazione.
TimelineRecordState	Stato del record.
TimelineReference	Rappresenta un riferimento a una sequenza temporale.

BuildLogReference

Object

Rappresenta un riferimento a un log di compilazione.

Nome	Tipo	Descrizione
id	integer (int32)	ID del log.
type	string	Tipo del percorso del log.
url	string	Collegamento completo alla risorsa di log.

Issue

Object

Rappresenta un problema (errore, avviso) associato a una compilazione.

Nome	Tipo	Descrizione
category	string	Categoria.
data	object
message	string	Descrizione del problema.
type	IssueType	Tipo (errore, avviso) del problema.

IssueType

Enumerazione

Tipo (errore, avviso) del problema.

Valore	Descrizione
error
warning

ReferenceLinks

Object

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome	Tipo	Descrizione
links	object	Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.

TaskReference

Object

Rappresenta un riferimento a un'attività.

Nome	Tipo	Descrizione
id	string (uuid)	ID della definizione dell'attività.
name	string	Nome della definizione dell'attività.
version	string	Versione della definizione dell'attività.

TaskResult

Enumerazione

Il risultato.

Valore	Descrizione
abandoned
canceled
failed
skipped
succeeded
succeededWithIssues

Timeline

Object

Rappresenta la sequenza temporale di una compilazione.

Nome	Tipo	Descrizione
changeId	integer (int32)	ID modifica.
id	string (uuid)	ID della sequenza temporale.
lastChangedBy	string (uuid)	Processo o persona che ha modificato l'ultima volta la sequenza temporale.
lastChangedOn	string (date-time)	Ora dell'ultima modifica della sequenza temporale.
records	TimelineRecord[]	Rappresenta una voce nella sequenza temporale di una compilazione.
url	string	URL REST della sequenza temporale.

TimelineAttempt

Object

Nome	Tipo	Descrizione
attempt	integer (int32)	Ottiene o imposta il tentativo del record.
recordId	string (uuid)	Ottiene o imposta l'identificatore di record che si trova all'interno della sequenza temporale specificata.
timelineId	string (uuid)	Ottiene o imposta l'identificatore della sequenza temporale proprietario del record che rappresenta questo tentativo.

TimelineRecord

Object

Rappresenta una voce nella sequenza temporale di una compilazione.

Nome	Tipo	Descrizione
_links	ReferenceLinks	Classe per rappresentare una raccolta di collegamenti di riferimento REST.
attempt	integer (int32)	Numero di tentativi di record.
changeId	integer (int32)	ID modifica.
currentOperation	string	Stringa che indica l'operazione corrente.
details	TimelineReference	Riferimento a una sequenza temporale secondaria.
errorCount	integer (int32)	Numero di errori generati da questa operazione.
finishTime	string (date-time)	Ora di fine.
id	string (uuid)	ID del record.
identifier	string	Identificatore stringa coerente tra i tentativi.
issues	Issue[]	Rappresenta un problema (errore, avviso) associato a una compilazione.
lastModified	string (date-time)	Ora dell'ultima modifica del record.
log	BuildLogReference	Riferimento al log prodotto da questa operazione.
name	string	Nome.
order	integer (int32)	Valore ordinale relativo ad altri record.
parentId	string (uuid)	ID dell'elemento padre del record.
percentComplete	integer (int32)	Percentuale di completamento corrente.
previousAttempts	TimelineAttempt[]
queueId	integer (int32)	ID coda della coda su cui è stata eseguita l'operazione.
result	TaskResult	Il risultato.
resultCode	string	Codice del risultato.
startTime	string (date-time)	Ora di inizio.
state	TimelineRecordState	Stato del record.
task	TaskReference	Riferimento all'attività rappresentata da questo record della sequenza temporale.
type	string	Tipo del record.
url	string	URL REST del record della sequenza temporale.
warningCount	integer (int32)	Numero di avvisi generati da questa operazione.
workerName	string	Nome dell'agente che esegue l'operazione.

TimelineRecordState

Enumerazione

Stato del record.

Valore	Descrizione
completed
inProgress
pending

TimelineReference

Object

Rappresenta un riferimento a una sequenza temporale.

Nome	Tipo	Descrizione
changeId	integer (int32)	ID modifica.
id	string (uuid)	ID della sequenza temporale.
url	string	URL REST della sequenza temporale.