Timeline - Get

Serviço:

Build

Versão da API:

7.1

Obtém detalhes de um build

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

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

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' 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 a linha do tempo de um build.
TimelineAttempt
TimelineRecord	Representa uma entrada na linha do tempo de um build.
TimelineRecordState	O estado do registro.
TimelineReference	Representa uma referência a uma linha do tempo.

BuildLogReference

Objeto

Representa uma referência a um log de build.

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

Issue

Objeto

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

Enumeração

O tipo (erro, aviso) do problema.

Valor	Description
error
warning

ReferenceLinks

Objeto

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

Objeto

Representa uma referência a uma tarefa.

Nome	Tipo	Description
id	string (uuid)	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

Enumeração

O resultado.

Valor	Description
abandoned
canceled
failed
skipped
succeeded
succeededWithIssues

Timeline

Objeto

Representa a linha do tempo de um build.

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

TimelineAttempt

Objeto

Nome	Tipo	Description
attempt	integer (int32)	Obtém ou define a tentativa do registro.
recordId	string (uuid)	Obtém ou define o identificador de registro localizado dentro da linha do tempo especificada.
timelineId	string (uuid)	Obtém ou define o identificador da linha do tempo que possui o registro que representa essa tentativa.

TimelineRecord

Objeto

Representa uma entrada na 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 (int32)	Número de tentativa de registro.
changeId	integer (int32)	A ID da alteração.
currentOperation	string	Uma cadeia de caracteres que indica a operação atual.
details	TimelineReference	Uma referência a uma sub-linha do tempo.
errorCount	integer (int32)	O número de erros produzidos por essa operação.
finishTime	string (date-time)	A hora de término.
id	string (uuid)	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 (date-time)	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 (int32)	Um valor ordinal relativo a outros registros.
parentId	string (uuid)	A ID do pai do registro.
percentComplete	integer (int32)	O percentual de conclusão atual.
previousAttempts	TimelineAttempt[]
queueId	integer (int32)	A ID da fila na qual a operação foi executada.
result	TaskResult	O resultado.
resultCode	string	O código de resultado.
startTime	string (date-time)	A hora de início.
state	TimelineRecordState	O estado do registro.
task	TaskReference	Uma referência à tarefa representada por este registro de linha do tempo.
type	string	O tipo do registro.
url	string	A URL REST do registro da linha do tempo.
warningCount	integer (int32)	O número de avisos produzidos por essa operação.
workerName	string	O nome do agente que está executando a operação.

TimelineRecordState

Enumeração

O estado do registro.

Valor	Description
completed
inProgress
pending

TimelineReference

Objeto

Representa uma referência a uma linha do tempo.

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