Timeline - Get

Serviço:

Build

Versão da API:

7.1-preview.2

Obtém detalhes de um build

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

Com parâmetros opcionais:

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
buildId	path	True	integer int32
organization	path	True	string	O nome da organização do Azure DevOps.
project	path	True	string	ID do projeto ou nome do projeto
timelineId	path		string uuid
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1-preview.2' para usar essa versão da API.
changeId	query		integer int32
planId	query		string uuid

Respostas

Nome	Tipo	Description
200 OK	Timeline	operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do 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

Escopos

Nome	Description
vso.build	Concede a capacidade de acessar artefatos de build, incluindo resultados de build, definições e solicitações e a capacidade de receber notificações sobre eventos de build por meio de ganchos de serviço.

Definições

Nome	Description
BuildLogReference	Representa uma referência a um log de build.
Issue	Representa um problema (erro, aviso) associado a um build.
IssueType	O tipo (erro, aviso) do problema.
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
TaskReference	Representa uma referência a uma tarefa.
TaskResult	O resultado.
Timeline	Representa o linha do tempo de um build.
TimelineAttempt
TimelineRecord	Representa uma entrada no linha do tempo de um build.
TimelineRecordState	O estado do registro.
TimelineReference	Representa uma referência a um linha do tempo.

BuildLogReference

Object

Representa uma referência a um log de build.

Nome	Tipo	Description
id	integer	A ID do log.
type	string	O tipo do local do log.
url	string	Um link completo para o recurso de log.

Issue

Object

Representa um problema (erro, aviso) associado a um build.

Nome	Tipo	Description
category	string	A categoria.
data	object
message	string	Uma descrição do problema.
type	IssueType	O tipo (erro, aviso) do problema.

IssueType

Enumeration

O tipo (erro, aviso) do problema.

Valor	Description
error
warning

ReferenceLinks

Object

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

TaskReference

Object

Representa uma referência a uma tarefa.

Nome	Tipo	Description
id	string	A ID da definição da tarefa.
name	string	O nome da definição da tarefa.
version	string	A versão da definição da tarefa.

TaskResult

Enumeration

O resultado.

Valor	Description
abandoned
canceled
failed
skipped
succeeded
succeededWithIssues

Timeline

Object

Representa o linha do tempo de um build.

Nome	Tipo	Description
changeId	integer	A ID da alteração.
id	string	A ID do linha do tempo.
lastChangedBy	string	O processo ou a pessoa que alterou a linha do tempo pela última vez.
lastChangedOn	string	A hora em que a linha do tempo foi alterada pela última vez.
records	TimelineRecord[]	Representa uma entrada no linha do tempo de um build.
url	string	A URL REST do linha do tempo.

TimelineAttempt

Object

Nome	Tipo	Description
attempt	integer	Obtém ou define a tentativa do registro.
recordId	string	Obtém ou define o identificador de registro localizado no linha do tempo especificado.
timelineId	string	Obtém ou define o identificador linha do tempo que possui o registro que representa essa tentativa.

TimelineRecord

Object

Representa uma entrada no linha do tempo de um build.

Nome	Tipo	Description
_links	ReferenceLinks	A classe para representar uma coleção de links de referência REST.
attempt	integer	Número de tentativa de registro.
changeId	integer	A ID da alteração.
currentOperation	string	Uma cadeia de caracteres que indica a operação atual.
details	TimelineReference	Uma referência a um sub-linha do tempo.
errorCount	integer	O número de erros produzidos por essa operação.
finishTime	string	A hora de término.
id	string	A ID do registro.
identifier	string	Identificador de cadeia de caracteres consistente entre tentativas.
issues	Issue[]	Representa um problema (erro, aviso) associado a um build.
lastModified	string	A hora em que o registro foi modificado pela última vez.
log	BuildLogReference	Uma referência ao log produzido por essa operação.
name	string	O nome.
order	integer	Um valor ordinal relativo a outros registros.
parentId	string	A ID do pai do registro.
percentComplete	integer	O percentual de conclusão atual.
previousAttempts	TimelineAttempt[]
queueId	integer	A ID da fila na qual a operação foi executada.
result	TaskResult	O resultado.
resultCode	string	O código de resultado.
startTime	string	A hora de início.
state	TimelineRecordState	O estado do registro.
task	TaskReference	Uma referência à tarefa representada por este registro linha do tempo.
type	string	O tipo do registro.
url	string	A URL REST do registro linha do tempo.
warningCount	integer	O número de avisos produzidos por essa operação.
workerName	string	O nome do agente que executa a operação.

TimelineRecordState

Enumeration

O estado do registro.

Valor	Description
completed
inProgress
pending

TimelineReference

Object

Representa uma referência a um linha do tempo.

Nome	Tipo	Description
changeId	integer	A ID da alteração.
id	string	A ID do linha do tempo.
url	string	A URL REST do linha do tempo.