Builds - Queue

참조

Service:: Build

API Version:: 7.1-preview.7

빌드 큐

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

With optional parameters:

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	일반 우선 순위입니다.

ReferenceLinks

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

다음을 통해 공유