다음을 통해 공유


Builds - Queue

빌드 큐

POST https://dev.azure.com/{organization}/{project}/_apis/build/builds?api-version=7.1-preview.7
POST https://dev.azure.com/{organization}/{project}/_apis/build/builds?ignoreWarnings={ignoreWarnings}&checkInTicket={checkInTicket}&sourceBuildId={sourceBuildId}&definitionId={definitionId}&api-version=7.1-preview.7

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
organization
path True

string

Azure DevOps 조직의 이름입니다.

project
path True

string

프로젝트 ID 또는 프로젝트 이름

api-version
query True

string

사용할 API의 버전입니다. 이 버전의 api를 사용하려면 '7.1-preview.7'로 설정해야 합니다.

checkInTicket
query

string

definitionId
query

integer

int32

본문 없이 빌드를 큐에 대기하는 선택적 정의 ID입니다. 유효한 본문이 있는 경우 무시됨

ignoreWarnings
query

boolean

sourceBuildId
query

integer

int32

요청 본문

Name 형식 Description
_links

ReferenceLinks

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

agentSpecification

AgentSpecification

빌드에 대한 에이전트 사양입니다.

appendCommitMessageToRunName

boolean

UI에서 BuildNumber에 커밋 메시지를 추가합니다.

buildNumber

string

빌드의 빌드 번호/이름입니다.

buildNumberRevision

integer

빌드 번호 수정 버전입니다.

controller

BuildController

빌드 컨트롤러입니다. 정의 형식이 Xaml인 경우에만 설정됩니다.

definition

DefinitionReference

빌드와 연결된 정의입니다.

deleted

boolean

빌드가 삭제되었는지 여부를 나타냅니다.

deletedBy

IdentityRef

빌드를 삭제한 프로세스 또는 사람의 ID입니다.

deletedDate

string

빌드가 삭제된 날짜입니다.

deletedReason

string

빌드가 삭제된 방법에 대한 설명입니다.

demands

Demand[]

이 빌드에 필요한 에이전트 기능을 나타내는 요구 사항 목록입니다.

finishTime

string

빌드가 완료된 시간입니다.

id

integer

빌드의 ID입니다.

lastChangedBy

IdentityRef

마지막으로 빌드를 변경한 프로세스 또는 사람을 나타내는 ID입니다.

lastChangedDate

string

빌드가 마지막으로 변경된 날짜입니다.

logs

BuildLogReference

빌드 로그에 대한 정보입니다.

orchestrationPlan

TaskOrchestrationPlanReference

빌드에 대한 오케스트레이션 계획입니다.

parameters

string

빌드에 대한 매개 변수입니다.

plans

TaskOrchestrationPlanReference[]

빌드와 연결된 오케스트레이션 계획(빌드, 정리)

priority

QueuePriority

빌드의 우선 순위입니다.

project

TeamProjectReference

팀 프로젝트입니다.

properties

PropertiesCollection

클래스는 속성 모음을 키-값 쌍의 컬렉션으로 나타냅니다. 를 제외한 DBNull 모든 기본 형식의 값(가 있는 TypeCode != TypeCode.Object모든 형식)이 허용됩니다. Byte[], Int32, Double, DateType 및 String 형식의 값은 해당 형식을 유지하며, 다른 기본 형식은 String으로 다시 조정됩니다. base64로 인코딩된 문자열로 예상되는 바이트[]

quality

string

xaml 빌드의 품질(양호, 불량 등)

queue

AgentPoolQueue

큐 입니다. 정의 형식이 빌드인 경우에만 설정됩니다. 경고: 이 필드는 더 이상 사용되지 않으며 작업 큐에 해당하지 않습니다.

queueOptions

QueueOptions

빌드를 큐에 대기하기 위한 추가 옵션입니다.

queuePosition

integer

큐에 있는 빌드의 현재 위치입니다.

queueTime

string

빌드가 큐에 대기된 시간입니다.

reason

BuildReason

빌드를 만든 이유입니다.

repository

BuildRepository

리포지토리입니다.

requestedBy

IdentityRef

빌드를 큐에 넣은 ID입니다.

requestedFor

IdentityRef

빌드를 대신하여 대기 중인 ID입니다.

result

BuildResult

빌드 결과입니다.

retainedByRelease

boolean

빌드가 릴리스에서 유지되는지 여부를 나타냅니다.

sourceBranch

string

원본 분기입니다.

sourceVersion

string

원본 버전

startTime

string

빌드가 시작된 시간입니다.

status

BuildStatus

빌드의 상태.

tags

string[]

templateParameters

object

템플릿 식 평가에 대한 매개 변수

triggerInfo

object

빌드를 트리거한 내용에 대한 Sourceprovider 관련 정보

triggeredByBuild

Build

빌드 완료 트리거를 통해 이 빌드를 트리거한 빌드입니다.

uri

string

빌드의 URI입니다.

url

string

빌드의 REST URL입니다.

validationResults

BuildRequestValidationResult[]

빌드 요청의 유효성을 검사한 결과를 나타냅니다.

응답

Name 형식 Description
200 OK

Build

성공한 작업

보안

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token 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

Scopes

Name Description
vso.build_execute 빌드 결과, 정의 및 요청을 포함하여 빌드 아티팩트 액세스 기능과 빌드를 큐에 대기하고 빌드 속성을 업데이트하며 서비스 후크를 통해 빌드 이벤트에 대한 알림을 받을 수 있는 기능을 부여합니다.

정의

Name Description
AgentPoolQueue

빌드를 실행하기 위한 큐를 나타냅니다.

AgentSpecification

풀 공급자가 정의한 에이전트의 사양입니다.

Build

빌드의 데이터 표현입니다.

BuildController
BuildLogReference

빌드 로그에 대한 참조를 나타냅니다.

BuildReason

빌드를 만든 이유입니다.

BuildRepository

빌드 정의에서 사용하는 리포지토리를 나타냅니다.

BuildRequestValidationResult

빌드 요청의 유효성을 검사한 결과를 나타냅니다.

BuildResult

빌드 결과입니다.

BuildStatus

빌드 상태.

ControllerStatus

컨트롤러의 상태.

DefinitionQueueStatus

이 정의에 대해 빌드를 큐에 대기할 수 있는지 여부를 나타내는 값입니다.

DefinitionReference

정의에 대한 참조를 나타냅니다.

DefinitionType

정의의 유형입니다.

Demand

정의 또는 빌드에서 사용하는 수요를 나타냅니다.

IdentityRef
ProjectState

프로젝트 상태입니다.

ProjectVisibility

프로젝트 표시 유형입니다.

PropertiesCollection

클래스는 키-값 쌍의 컬렉션으로 속성 모음을 나타냅니다. 를 제외한 모든 기본 형식의 값(을 TypeCode != TypeCode.Object제외한 DBNull 모든 형식)이 허용됩니다. Byte[], Int32, Double, DateType 및 String 형식의 값은 해당 형식을 유지하며 다른 기본 형식은 String으로 다시 조정됩니다. byte[] base64로 인코딩된 문자열로 예상됩니다.

QueueOptions

빌드를 큐에 대기하기 위한 추가 옵션입니다.

QueuePriority

빌드의 우선 순위입니다.

ReferenceLinks

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

TaskAgentPoolReference

에이전트 풀에 대한 참조를 나타냅니다.

TaskOrchestrationPlanReference

오케스트레이션 계획에 대한 참조를 나타냅니다.

TeamProjectReference

TeamProject에 대한 단순 참조를 나타냅니다.

ValidationResult

결과입니다.

AgentPoolQueue

빌드를 실행하기 위한 큐를 나타냅니다.

Name 형식 Description
_links

ReferenceLinks

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

id

integer

큐의 ID입니다.

name

string

큐의 이름입니다.

pool

TaskAgentPoolReference

이 큐에서 사용하는 풀입니다.

url

string

리소스에 대한 전체 http 링크입니다.

AgentSpecification

풀 공급자가 정의한 에이전트의 사양입니다.

Name 형식 Description
identifier

string

에이전트 사양 고유 식별자입니다.

Build

빌드의 데이터 표현입니다.

Name 형식 Description
_links

ReferenceLinks

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

agentSpecification

AgentSpecification

빌드에 대한 에이전트 사양입니다.

appendCommitMessageToRunName

boolean

UI에서 BuildNumber에 커밋 메시지를 추가합니다.

buildNumber

string

빌드의 빌드 번호/이름입니다.

buildNumberRevision

integer

빌드 번호 수정 버전입니다.

controller

BuildController

빌드 컨트롤러입니다. 정의 형식이 Xaml인 경우에만 설정됩니다.

definition

DefinitionReference

빌드와 연결된 정의입니다.

deleted

boolean

빌드가 삭제되었는지 여부를 나타냅니다.

deletedBy

IdentityRef

빌드를 삭제한 프로세스 또는 사용자의 ID입니다.

deletedDate

string

빌드가 삭제된 날짜입니다.

deletedReason

string

빌드가 삭제된 방법에 대한 설명입니다.

demands

Demand[]

이 빌드에 필요한 에이전트 기능을 나타내는 요구 사항 목록입니다.

finishTime

string

빌드가 완료된 시간입니다.

id

integer

빌드의 ID입니다.

lastChangedBy

IdentityRef

마지막으로 빌드를 변경한 프로세스 또는 사람을 나타내는 ID입니다.

lastChangedDate

string

빌드가 마지막으로 변경된 날짜입니다.

logs

BuildLogReference

빌드 로그에 대한 정보입니다.

orchestrationPlan

TaskOrchestrationPlanReference

빌드에 대한 오케스트레이션 계획입니다.

parameters

string

빌드에 대한 매개 변수입니다.

plans

TaskOrchestrationPlanReference[]

빌드와 연결된 오케스트레이션 계획(빌드, 정리)

priority

QueuePriority

빌드의 우선 순위입니다.

project

TeamProjectReference

팀 프로젝트입니다.

properties

PropertiesCollection

클래스는 속성 모음을 키-값 쌍의 컬렉션으로 나타냅니다. 를 제외한 DBNull 모든 기본 형식의 값(가 있는 TypeCode != TypeCode.Object모든 형식)이 허용됩니다. Byte[], Int32, Double, DateType 및 String 형식의 값은 해당 형식을 유지하며, 다른 기본 형식은 String으로 다시 조정됩니다. base64로 인코딩된 문자열로 예상되는 바이트[]

quality

string

xaml 빌드의 품질(양호, 불량 등)

queue

AgentPoolQueue

큐 입니다. 정의 형식이 빌드인 경우에만 설정됩니다. 경고: 이 필드는 더 이상 사용되지 않으며 작업 큐에 해당하지 않습니다.

queueOptions

QueueOptions

빌드를 큐에 대기하기 위한 추가 옵션입니다.

queuePosition

integer

큐에 있는 빌드의 현재 위치입니다.

queueTime

string

빌드가 큐에 대기된 시간입니다.

reason

BuildReason

빌드를 만든 이유입니다.

repository

BuildRepository

리포지토리입니다.

requestedBy

IdentityRef

빌드를 큐에 넣은 ID입니다.

requestedFor

IdentityRef

빌드를 대신하여 대기 중인 ID입니다.

result

BuildResult

빌드 결과입니다.

retainedByRelease

boolean

빌드가 릴리스에서 유지되는지 여부를 나타냅니다.

sourceBranch

string

원본 분기입니다.

sourceVersion

string

원본 버전

startTime

string

빌드가 시작된 시간입니다.

status

BuildStatus

빌드의 상태.

tags

string[]

templateParameters

object

템플릿 식 평가에 대한 매개 변수

triggerInfo

object

빌드를 트리거한 내용에 대한 Sourceprovider 관련 정보

triggeredByBuild

Build

빌드 완료 트리거를 통해 이 빌드를 트리거한 빌드입니다.

uri

string

빌드의 URI입니다.

url

string

빌드의 REST URL입니다.

validationResults

BuildRequestValidationResult[]

빌드 요청의 유효성을 검사한 결과를 나타냅니다.

BuildController

Name 형식 Description
_links

ReferenceLinks

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

createdDate

string

컨트롤러를 만든 날짜입니다.

description

string

컨트롤러에 대한 설명입니다.

enabled

boolean

컨트롤러를 사용할 수 있는지 여부를 나타냅니다.

id

integer

리소스의 ID

name

string

연결된 리소스의 이름(정의 이름, 컨트롤러 이름 등)

status

ControllerStatus

컨트롤러의 상태.

updatedDate

string

컨트롤러가 마지막으로 업데이트된 날짜입니다.

uri

string

컨트롤러의 URI입니다.

url

string

리소스에 대한 전체 http 링크

BuildLogReference

빌드 로그에 대한 참조를 나타냅니다.

Name 형식 Description
id

integer

로그의 ID입니다.

type

string

로그 위치의 형식입니다.

url

string

로그 리소스에 대한 전체 링크입니다.

BuildReason

빌드를 만든 이유입니다.

Name 형식 Description
all

string

모든 이유.

batchedCI

string

트리거 TriggerType.BatchedContinuousIntegration에 대한 빌드가 시작되었습니다.

buildCompletion

string

다른 빌드가 완료되면 빌드가 시작되었습니다.

checkInShelveset

string

ContinuousIntegrationType.Gated 트리거에 대한 빌드가 시작되었습니다.

individualCI

string

트리거 TriggerType.ContinuousIntegration에 대한 빌드가 시작되었습니다.

manual

string

빌드가 수동으로 시작되었습니다.

none

string

이유가 없습니다. 이 값을 사용하면 안 됩니다.

pullRequest

string

빌드는 끌어오기 요청에 의해 시작되었습니다. 리소스 버전 3에 추가되었습니다.

resourceTrigger

string

파이프라인의 리소스가 트리거할 때 빌드가 시작되었습니다.

schedule

string

트리거 TriggerType.Schedule에 대한 빌드가 시작되었습니다.

scheduleForced

string

트리거 TriggerType.ScheduleForced에 대한 빌드가 시작되었습니다.

triggered

string

빌드가 보존 정책 목적으로 트리거되었습니다.

userCreated

string

사용자가 빌드를 만들었습니다.

validateShelveset

string

프라이빗 유효성 검사를 위해 빌드가 수동으로 시작되었습니다.

BuildRepository

빌드 정의에서 사용하는 리포지토리를 나타냅니다.

Name 형식 Description
checkoutSubmodules

boolean

하위 모듈을 체크 아웃할지 여부를 나타냅니다.

clean

string

리포지토리에서 코드를 받을 때 대상 폴더를 클린 여부를 나타냅니다.

defaultBranch

string

기본 분기 이름입니다.

id

string

리포지토리의 ID입니다.

name

string

리포지토리의 이름입니다.

properties

object

rootFolder

string

루트 폴더입니다.

type

string

리포지토리의 형식입니다.

url

string

리포지토리의 URL입니다.

BuildRequestValidationResult

빌드 요청의 유효성을 검사한 결과를 나타냅니다.

Name 형식 Description
message

string

결과와 연관된 메시지입니다.

result

ValidationResult

결과입니다.

BuildResult

빌드 결과입니다.

Name 형식 Description
canceled

string

시작하기 전에 빌드가 취소되었습니다.

failed

string

빌드가 실패했습니다.

none

string

결과 없음

partiallySucceeded

string

빌드가 컴파일을 성공적으로 완료했지만 다른 오류가 발생했습니다.

succeeded

string

빌드가 성공적으로 완료되었습니다.

BuildStatus

빌드 상태.

Name 형식 Description
all

string

모든 상태입니다.

cancelling

string

빌드가 취소됨

completed

string

빌드가 완료되었습니다.

inProgress

string

빌드가 현재 진행 중입니다.

none

string

상태가 없습니다.

notStarted

string

빌드가 아직 시작되지 않았습니다.

postponed

string

빌드가 큐에서 비활성 상태입니다.

ControllerStatus

컨트롤러의 상태.

Name 형식 Description
available

string

빌드 컨트롤러를 현재 사용할 수 있음을 나타냅니다.

offline

string

빌드 컨트롤러가 오프라인으로 전환되었음을 나타냅니다.

unavailable

string

빌드 컨트롤러에 연결할 수 없음을 나타냅니다.

DefinitionQueueStatus

이 정의에 대해 빌드를 큐에 대기할 수 있는지 여부를 나타내는 값입니다.

Name 형식 Description
disabled

string

정의 큐를 사용하지 않도록 설정하면 사용자가 빌드를 큐에 대기할 수 없으며 시스템은 예약, 제어 또는 연속 통합 빌드를 큐에 대기하지 않습니다. 큐에 이미 있는 빌드는 시스템에서 시작되지 않습니다.

enabled

string

정의 큐를 사용하도록 설정하면 사용자가 빌드를 큐에 대기할 수 있고, 시스템은 예약, 제어 및 연속 통합 빌드를 큐에 대기하고, 대기된 빌드는 시스템에서 시작합니다.

paused

string

정의 큐를 일시 중지하면 사용자가 빌드를 큐에 대기할 수 있으며 시스템은 예약, 제어 및 연속 통합 빌드를 큐에 대기합니다. 큐의 빌드는 시스템에서 시작되지 않습니다.

DefinitionReference

정의에 대한 참조를 나타냅니다.

Name 형식 Description
createdDate

string

이 버전의 정의가 만들어진 날짜입니다.

id

integer

참조된 정의의 ID입니다.

name

string

참조된 정의의 이름입니다.

path

string

정의의 폴더 경로입니다.

project

TeamProjectReference

프로젝트에 대한 참조입니다.

queueStatus

DefinitionQueueStatus

이 정의에 대해 빌드를 큐에 대기할 수 있는지 여부를 나타내는 값입니다.

revision

integer

정의 수정 번호입니다.

type

DefinitionType

정의의 유형입니다.

uri

string

정의의 URI입니다.

url

string

정의의 REST URL입니다.

DefinitionType

정의의 유형입니다.

Name 형식 Description
build

string

xaml

string

Demand

정의 또는 빌드에서 사용하는 수요를 나타냅니다.

Name 형식 Description
name

string

수요에서 참조하는 기능의 이름입니다.

value

string

요구되는 값입니다.

IdentityRef

Name 형식 Description
_links

ReferenceLinks

이 필드에는 그래프 제목에 대한 0개 이상의 흥미로운 링크가 포함되어 있습니다. 이러한 링크를 호출하여 이 그래프 제목에 대한 추가 관계 또는 자세한 정보를 얻을 수 있습니다.

descriptor

string

설명자는 시스템이 실행되는 동안 그래프 제목을 참조하는 기본 방법입니다. 이 필드는 계정과 조직 모두에서 동일한 그래프 제목을 고유하게 식별합니다.

directoryAlias

string

사용되지 않음 - IdentityRef "_links" 사전의 "자체" 항목에서 참조된 Graph 사용자를 쿼리하여 검색할 수 있습니다.

displayName

string

그래프 주체의 고유하지 않은 표시 이름입니다. 이 필드를 변경하려면 원본 공급자에서 해당 값을 변경해야 합니다.

id

string

imageUrl

string

사용되지 않음 - IdentityRef "_links" 사전의 "아바타" 항목에서 사용할 수 있습니다.

inactive

boolean

사용되지 않음 - GraphUser "_links" 사전의 "membershipState" 항목에서 참조되는 Graph 멤버 자격 상태를 쿼리하여 검색할 수 있습니다.

isAadIdentity

boolean

사용되지 않음 - 설명자의 주체 형식(Descriptor.IsAadUserType/Descriptor.IsAadGroupType)에서 유추할 수 있습니다.

isContainer

boolean

사용되지 않음 - 설명자의 주체 형식에서 유추할 수 있음(Descriptor.IsGroupType)

isDeletedInOrigin

boolean

profileUrl

string

사용되지 않음 - ToIdentityRef의 대부분의 기존 구현에서 사용되지 않음

uniqueName

string

사용되지 않음 - 대신 Domain+PrincipalName 사용

url

string

이 URL은 이 그래프 주체의 원본 리소스에 대한 전체 경로입니다.

ProjectState

프로젝트 상태입니다.

Name 형식 Description
all

string

삭제됨을 제외한 모든 프로젝트는 상태에 관계없이 수행됩니다.

createPending

string

프로젝트를 만들기 위해 큐에 대기했지만 프로세스가 아직 시작되지 않았습니다.

deleted

string

프로젝트가 삭제되었습니다.

deleting

string

프로젝트가 삭제되는 중입니다.

new

string

프로젝트가 만들어지는 중입니다.

unchanged

string

프로젝트가 변경되지 않았습니다.

wellFormed

string

프로젝트가 완전히 만들어지고 사용할 준비가 된 것입니다.

ProjectVisibility

프로젝트 표시 유형입니다.

Name 형식 Description
private

string

프로젝트는 명시적 액세스 권한이 있는 사용자에게만 표시됩니다.

public

string

모든 사용자에게 프로젝트가 표시됩니다.

PropertiesCollection

클래스는 키-값 쌍의 컬렉션으로 속성 모음을 나타냅니다. 를 제외한 모든 기본 형식의 값(을 TypeCode != TypeCode.Object제외한 DBNull 모든 형식)이 허용됩니다. Byte[], Int32, Double, DateType 및 String 형식의 값은 해당 형식을 유지하며 다른 기본 형식은 String으로 다시 조정됩니다. byte[] base64로 인코딩된 문자열로 예상됩니다.

Name 형식 Description
count

integer

컬렉션의 속성 수입니다.

item

object

keys

string[]

컬렉션의 키 집합입니다.

values

string[]

컬렉션의 값 집합입니다.

QueueOptions

빌드를 큐에 대기하기 위한 추가 옵션입니다.

Name 형식 Description
doNotRun

string

빌드에 대한 계획 ID를 만들고 실행하지 마세요.

none

string

큐 옵션 없음

QueuePriority

빌드의 우선 순위입니다.

Name 형식 Description
aboveNormal

string

정상 우선 순위보다 높습니다.

belowNormal

string

정상 우선 순위보다 낮습니다.

high

string

높은 우선 순위.

low

string

낮은 우선 순위.

normal

string

일반 우선 순위입니다.

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

Name 형식 Description
links

object

링크의 읽기 전용 보기입니다. 참조 링크는 읽기 전용이므로 읽기 전용으로만 노출하려고 합니다.

TaskAgentPoolReference

에이전트 풀에 대한 참조를 나타냅니다.

Name 형식 Description
id

integer

풀 ID입니다.

isHosted

boolean

이 풀이 서비스에서 관리되는지 여부를 나타내는 값입니다.

name

string

풀 이름입니다.

TaskOrchestrationPlanReference

오케스트레이션 계획에 대한 참조를 나타냅니다.

Name 형식 Description
orchestrationType

integer

계획의 유형입니다.

planId

string

계획의 ID입니다.

TeamProjectReference

TeamProject에 대한 단순 참조를 나타냅니다.

Name 형식 Description
abbreviation

string

프로젝트 약어입니다.

defaultTeamImageUrl

string

기본 팀 ID 이미지의 URL입니다.

description

string

프로젝트의 설명(있는 경우)입니다.

id

string

프로젝트 식별자입니다.

lastUpdateTime

string

프로젝트 마지막 업데이트 시간입니다.

name

string

프로젝트 이름입니다.

revision

integer

프로젝트 수정 버전입니다.

state

ProjectState

프로젝트 상태입니다.

url

string

개체의 전체 버전에 대한 URL입니다.

visibility

ProjectVisibility

프로젝트 표시 유형입니다.

ValidationResult

결과입니다.

Name 형식 Description
error

string

ok

string

warning

string