Timeline - Get

Служба:

Build

Версия API:

7.1

Возвращает сведения о сборке

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
buildId	path	True	integer (int32)
organization	path	True	string	Имя организации Azure DevOps.
project	path	True	string	Идентификатор проекта или имя проекта
timelineId	path		string (uuid)
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение "7.1".
changeId	query		integer (int32)
planId	query		string (uuid)

Ответы

Имя	Тип	Описание
200 OK	Timeline	успешная операция

Безопасность

oauth2

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL-адрес токена: 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

Области

Имя	Описание
vso.build	Предоставляет возможность доступа к артефактам сборки, включая результаты сборки, определения и запросы, а также возможность получать уведомления о событиях сборки с помощью перехватчиков служб.

Определения

Имя	Описание
BuildLogReference	Представляет ссылку на журнал сборки.
Issue	Представляет проблему (ошибку, предупреждение), связанную со сборкой.
IssueType	Тип (ошибка, предупреждение) проблемы.
ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
TaskReference	Представляет ссылку на задачу.
TaskResult	Результат.
Timeline	Представляет временную шкалу сборки.
TimelineAttempt
TimelineRecord	Представляет запись на временной шкале сборки.
TimelineRecordState	Состояние записи.
TimelineReference	Представляет ссылку на временную шкалу.

BuildLogReference

Object

Представляет ссылку на журнал сборки.

Имя	Тип	Описание
id	integer (int32)	Идентификатор журнала.
type	string	Тип расположения журнала.
url	string	Полная ссылка на ресурс журнала.

Issue

Object

Представляет проблему (ошибку, предупреждение), связанную со сборкой.

Имя	Тип	Описание
category	string	Категория.
data	object
message	string	Описание проблемы.
type	IssueType	Тип (ошибка, предупреждение) проблемы.

IssueType

Перечисление

Тип (ошибка, предупреждение) проблемы.

Значение	Описание
error
warning

ReferenceLinks

Object

Класс, представляющий коллекцию ссылок REST.

Имя	Тип	Описание
links	object	Режим чтения ссылок. Так как ссылки ссылки доступны только для чтения, мы хотим предоставлять их только как доступные только для чтения.

TaskReference

Object

Представляет ссылку на задачу.

Имя	Тип	Описание
id	string (uuid)	Идентификатор определения задачи.
name	string	Имя определения задачи.
version	string	Версия определения задачи.

TaskResult

Перечисление

Результат.

Значение	Описание
abandoned
canceled
failed
skipped
succeeded
succeededWithIssues

Timeline

Object

Представляет временную шкалу сборки.

Имя	Тип	Описание
changeId	integer (int32)	Идентификатор изменения.
id	string (uuid)	Идентификатор временной шкалы.
lastChangedBy	string (uuid)	Процесс или пользователь, который последний раз изменил временную шкалу.
lastChangedOn	string (date-time)	Время последнего изменения временной шкалы.
records	TimelineRecord[]	Представляет запись на временной шкале сборки.
url	string	URL-адрес rest временной шкалы.

TimelineAttempt

Object

Имя	Тип	Описание
attempt	integer (int32)	Возвращает или задает попытку записи.
recordId	string (uuid)	Возвращает или задает идентификатор записи, расположенный в указанной временной шкале.
timelineId	string (uuid)	Возвращает или задает идентификатор временной шкалы, принадлежащий записи, представляющей эту попытку.

TimelineRecord

Object

Представляет запись на временной шкале сборки.

Имя	Тип	Описание
_links	ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
attempt	integer (int32)	Число попыток записи.
changeId	integer (int32)	Идентификатор изменения.
currentOperation	string	Строка, указывающая текущую операцию.
details	TimelineReference	Ссылка на под временную шкалу.
errorCount	integer (int32)	Количество ошибок, создаваемых этой операцией.
finishTime	string (date-time)	Время окончания.
id	string (uuid)	Идентификатор записи.
identifier	string	Строковый идентификатор, согласованный между попытками.
issues	Issue[]	Представляет проблему (ошибку, предупреждение), связанную со сборкой.
lastModified	string (date-time)	Время последнего изменения записи.
log	BuildLogReference	Ссылка на журнал, созданный этой операцией.
name	string	Имя.
order	integer (int32)	Порядковое значение относительно других записей.
parentId	string (uuid)	Идентификатор родительского элемента записи.
percentComplete	integer (int32)	Текущий процент завершения.
previousAttempts	TimelineAttempt[]
queueId	integer (int32)	Идентификатор очереди очереди, в которую выполнялась операция.
result	TaskResult	Результат.
resultCode	string	Код результата.
startTime	string (date-time)	Время начала.
state	TimelineRecordState	Состояние записи.
task	TaskReference	Ссылка на задачу, представленную этой записью временной шкалы.
type	string	Тип записи.
url	string	URL-адрес REST записи временной шкалы.
warningCount	integer (int32)	Количество предупреждений, созданных этой операцией.
workerName	string	Имя агента, выполняющего операцию.

TimelineRecordState

Перечисление

Состояние записи.

Значение	Описание
completed
inProgress
pending

TimelineReference

Object

Представляет ссылку на временную шкалу.

Имя	Тип	Описание
changeId	integer (int32)	Идентификатор изменения.
id	string (uuid)	Идентификатор временной шкалы.
url	string	URL-адрес rest временной шкалы.