Partilhar via


Timeline - Get

Obtém detalhes de um build

GET https://dev.azure.com/{organization}/{project}/_apis/build/builds/{buildId}/timeline/{timelineId}?api-version=7.1
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

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

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

O tipo (erro, aviso) do problema.

Valor Description
error
warning

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

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

O resultado.

Valor Description
abandoned
canceled
failed
skipped
succeeded
succeededWithIssues

Timeline

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

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

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

O estado do registro.

Valor Description
completed
inProgress
pending

TimelineReference

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.