Data representation of a build.

interface Build {
    _links?: any;
    agentSpecification?: AgentSpecification;
    appendCommitMessageToRunName?: boolean;
    buildNumber?: string;
    buildNumberRevision?: number;
    controller?: BuildController;
    definition?: DefinitionReference;
    deleted?: boolean;
    deletedBy?: IdentityRef;
    deletedDate?: Date;
    deletedReason?: string;
    demands?: Demand[];
    finishTime?: Date;
    id?: number;
    keepForever?: boolean;
    lastChangedBy?: IdentityRef;
    lastChangedDate?: Date;
    logs?: BuildLogReference;
    orchestrationPlan?: TaskOrchestrationPlanReference;
    parameters?: string;
    plans?: TaskOrchestrationPlanReference[];
    priority?: QueuePriority;
    project?: TeamProjectReference;
    properties?: any;
    quality?: string;
    queue?: AgentPoolQueue;
    queueOptions?: QueueOptions;
    queuePosition?: number;
    queueTime?: Date;
    reason?: BuildReason;
    repository?: BuildRepository;
    requestedBy?: IdentityRef;
    requestedFor?: IdentityRef;
    result?: BuildResult;
    retainedByRelease?: boolean;
    sourceBranch?: string;
    sourceVersion?: string;
    startTime?: Date;
    status?: BuildStatus;
    tags?: string[];
    templateParameters?: { [key: string]: string };
    triggeredByBuild?: Build;
    triggerInfo?: { [key: string]: string };
    uri?: string;
    url?: string;
    validationResults?: BuildRequestValidationResult[];
}

Properties

_links?: any
agentSpecification?: AgentSpecification

The agent specification for the build.

appendCommitMessageToRunName?: boolean

Append Commit Message To BuildNumber in UI.

buildNumber?: string

The build number/name of the build.

buildNumberRevision?: number

The build number revision.

controller?: BuildController

The build controller. This is only set if the definition type is Xaml.

definition?: DefinitionReference

The definition associated with the build.

deleted?: boolean

Indicates whether the build has been deleted.

deletedBy?: IdentityRef

The identity of the process or person that deleted the build.

deletedDate?: Date

The date the build was deleted.

deletedReason?: string

The description of how the build was deleted.

demands?: Demand[]

A list of demands that represents the agent capabilities required by this build.

finishTime?: Date

The time that the build was completed.

id?: number

The ID of the build.

keepForever?: boolean

Indicates whether the build should be skipped by retention policies.

lastChangedBy?: IdentityRef

The identity representing the process or person that last changed the build.

lastChangedDate?: Date

The date the build was last changed.

Information about the build logs.

orchestrationPlan?: TaskOrchestrationPlanReference

The orchestration plan for the build.

parameters?: string

The parameters for the build.

Orchestration plans associated with the build (build, cleanup)

priority?: QueuePriority

Azure Pipelines does not support job priority. This field is deprecated.

The team project.

properties?: any
quality?: string

The quality of the xaml build (good, bad, etc.)

The queue. This is only set if the definition type is Build. WARNING: this field is deprecated and does not corresponds to the jobs queues.

queueOptions?: QueueOptions

Additional options for queueing the build.

queuePosition?: number

The current position of the build in the queue.

queueTime?: Date

The time that the build was queued.

reason?: BuildReason

The reason that the build was created.

repository?: BuildRepository

The repository.

requestedBy?: IdentityRef

The identity that queued the build.

requestedFor?: IdentityRef

The identity on whose behalf the build was queued.

result?: BuildResult

The build result.

retainedByRelease?: boolean

Indicates whether the build is retained by a release.

sourceBranch?: string

The source branch.

sourceVersion?: string

The source version.

startTime?: Date

The time that the build was started.

status?: BuildStatus

The status of the build.

tags?: string[]
templateParameters?: { [key: string]: string }

Parameters to template expression evaluation

triggeredByBuild?: Build

The build that triggered this build via a Build completion trigger.

triggerInfo?: { [key: string]: string }

Sourceprovider-specific information about what triggered the build

uri?: string

The URI of the build.

url?: string

The REST URL of the build.

validationResults?: BuildRequestValidationResult[]