Builds - Queue

Başvuru

Service:: Build

API Version:: 7.1-preview.7

Derlemeyi kuyruğa alır

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 Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
project	path	True	string	Proje Kimliği veya proje adı
api-version	query	True	string	Kullanılacak API sürümü. Api'nin bu sürümünü kullanmak için bu değer '7.1-preview.7' olarak ayarlanmalıdır.
checkInTicket	query		string
definitionId	query		integer int32	Gövdesi olmayan bir derlemeyi kuyruğa almak için isteğe bağlı tanım kimliği. Geçerli bir gövde varsa yoksayılır
ignoreWarnings	query		boolean
sourceBuildId	query		integer int32

İstek Gövdesi

Name	Tür	Description
_links	ReferenceLinks	REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
agentSpecification	AgentSpecification	Derleme için aracı belirtimi.
appendCommitMessageToRunName	boolean	Ui'de BuildNumber'a commit iletisi ekleyin.
buildNumber	string	Derlemenin derleme numarası/adı.
buildNumberRevision	integer	Derleme numarası düzeltmesi.
controller	BuildController	Derleme denetleyicisi. Bu yalnızca tanım türü Xaml ise ayarlanır.
definition	DefinitionReference	Derlemeyle ilişkili tanım.
deleted	boolean	Derlemenin silinip silinmediğini gösterir.
deletedBy	IdentityRef	Derlemeyi silmiş olan işlemin veya kişinin kimliği.
deletedDate	string	Derlemenin silindiği tarih.
deletedReason	string	Derlemenin nasıl silindiğinin açıklaması.
demands	Demand[]	Bu derlemenin gerektirdiği aracı özelliklerini temsil eden taleplerin listesi.
finishTime	string	Derlemenin tamamlanma zamanı.
id	integer	Derlemenin kimliği.
lastChangedBy	IdentityRef	Derlemeyi en son değiştiren işlemi veya kişiyi temsil eden kimlik.
lastChangedDate	string	Derlemenin son değiştirildiği tarih.
logs	BuildLogReference	Derleme günlükleri hakkında bilgi.
orchestrationPlan	TaskOrchestrationPlanReference	Derleme için düzenleme planı.
parameters	string	Derlemenin parametreleri.
plans	TaskOrchestrationPlanReference[]	Derlemeyle ilişkili düzenleme planları (derleme, temizleme)
priority	QueuePriority	Derlemenin önceliği.
project	TeamProjectReference	Takım projesi.
properties	PropertiesCollection	sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik çantasını temsil eder. Dışındaki `DBNull` tüm ilkel türlerin (ile herhangi bir `TypeCode != TypeCode.Object`tür) değerleri kabul edilir. Byte[], Int32, Double, DateType ve String türündeki değerler türlerini korur, diğer temel öğeler Dize olarak retuned edilir. Byte[] base64 kodlanmış dize olarak bekleniyor.
quality	string	xaml derlemesinin kalitesi (iyi, kötü vb.)
queue	AgentPoolQueue	Kuyruk. Bu yalnızca tanım türü Build ise ayarlanır. UYARI: Bu alan kullanım dışıdır ve iş kuyruklarına karşılık gelmez.
queueOptions	QueueOptions	Derlemeyi kuyruğa alma için ek seçenekler.
queuePosition	integer	Derlemenin kuyruktaki geçerli konumu.
queueTime	string	Derlemenin kuyruğa alındığı zaman.
reason	BuildReason	Derlemenin oluşturulma nedeni.
repository	BuildRepository	Depo.
requestedBy	IdentityRef	Derlemeyi kuyruğa alan kimlik.
requestedFor	IdentityRef	Derlemenin adına kuyruğa alınan kimlik.
result	BuildResult	Derleme sonucu.
retainedByRelease	boolean	Derlemenin bir sürüm tarafından korunup korunmadığını gösterir.
sourceBranch	string	Kaynak dal.
sourceVersion	string	Kaynak sürüm.
startTime	string	Derlemenin başlatıldığı saat.
status	BuildStatus	Derlemenin durumu.
tags	string[]
templateParameters	object	Şablon ifadesi değerlendirmesine yönelik parametreler
triggerInfo	object	Derlemeyi neyin tetiklediği hakkında sourceprovider'a özgü bilgiler
triggeredByBuild	Build	Derleme tamamlama tetikleyicisi aracılığıyla bu derlemeyi tetikleyen derleme.
uri	string	Derlemenin URI'sini.
url	string	Derlemenin REST URL'si.
validationResults	BuildRequestValidationResult[]	Derleme isteğini doğrulamanın sonucunu temsil eder.

Yanıtlar

Name	Tür	Description
200 OK	Build	başarılı işlem

Güvenlik

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	Derleme sonuçları, tanımlar ve istekler dahil olmak üzere derleme yapıtlarına erişme ve derlemeyi kuyruğa alma, derleme özelliklerini güncelleştirme ve hizmet kancaları aracılığıyla derleme olayları hakkında bildirim alma olanağı verir.

Tanımlar

Name	Description
AgentPoolQueue	Derlemeleri çalıştırmak için bir kuyruğu temsil eder.
AgentSpecification	Havuz sağlayıcısı tarafından tanımlanan aracının belirtimi.
Build	Derlemenin veri gösterimi.
BuildController
BuildLogReference	Derleme günlüğüne yapılan başvuruları temsil eder.
BuildReason	Derlemenin oluşturulma nedeni.
BuildRepository	Derleme tanımı tarafından kullanılan bir deposunu temsil eder.
BuildRequestValidationResult	Derleme isteğini doğrulamanın sonucunu temsil eder.
BuildResult	Derleme sonucu.
BuildStatus	Derleme durumu.
ControllerStatus	Denetleyicinin durumu.
DefinitionQueueStatus	Derlemelerin bu tanıma göre kuyruğa alınıp alınamayacağını gösteren bir değer.
DefinitionReference	Bir tanımın başvurularını temsil eder.
DefinitionType	Tanımın türü.
Demand	Bir tanım veya derleme tarafından kullanılan bir talebi temsil eder.
IdentityRef
ProjectState	Proje durumu.
ProjectVisibility	Proje görünürlüğü.
PropertiesCollection	sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik çantasını temsil eder. Dışındaki `DBNull` tüm ilkel türlerin (ile herhangi bir `TypeCode != TypeCode.Object`tür) değerleri kabul edilir. Byte[], Int32, Double, DateType ve String türündeki değerler türlerini korur, diğer temel öğeler Dize olarak retuned edilir. Byte[] base64 kodlanmış dize olarak bekleniyor.
QueueOptions	Derlemeyi kuyruğa alma için ek seçenekler.
QueuePriority	Derlemenin önceliği.
ReferenceLinks	REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
TaskAgentPoolReference	Aracı havuzu başvurularını temsil eder.
TaskOrchestrationPlanReference	Düzenleme planı başvurularını temsil eder.
TeamProjectReference	TeamProject'e basit bir başvuru temsil eder.
ValidationResult	Sonuç.

AgentPoolQueue

Derlemeleri çalıştırmak için bir kuyruğu temsil eder.

Name	Tür	Description
_links	ReferenceLinks	REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
id	integer	Kuyruğun kimliği.
name	string	Kuyruğun adı.
pool	TaskAgentPoolReference	Bu kuyruk tarafından kullanılan havuz.
url	string	Kaynağın tam http bağlantısı.

AgentSpecification

Havuz sağlayıcısı tarafından tanımlanan aracının belirtimi.

Name	Tür	Description
identifier	string	Aracı belirtimi benzersiz tanımlayıcısı.

Build

Derlemenin veri gösterimi.

Name	Tür	Description
_links	ReferenceLinks	REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
agentSpecification	AgentSpecification	Derleme için aracı belirtimi.
appendCommitMessageToRunName	boolean	Ui'de BuildNumber'a commit iletisi ekleyin.
buildNumber	string	Derlemenin derleme numarası/adı.
buildNumberRevision	integer	Derleme numarası düzeltmesi.
controller	BuildController	Derleme denetleyicisi. Bu yalnızca tanım türü Xaml ise ayarlanır.
definition	DefinitionReference	Derlemeyle ilişkili tanım.
deleted	boolean	Derlemenin silinip silinmediğini gösterir.
deletedBy	IdentityRef	Derlemeyi silmiş olan işlemin veya kişinin kimliği.
deletedDate	string	Derlemenin silindiği tarih.
deletedReason	string	Derlemenin nasıl silindiğinin açıklaması.
demands	Demand[]	Bu derlemenin gerektirdiği aracı özelliklerini temsil eden taleplerin listesi.
finishTime	string	Derlemenin tamamlanma zamanı.
id	integer	Derlemenin kimliği.
lastChangedBy	IdentityRef	Derlemeyi en son değiştiren işlemi veya kişiyi temsil eden kimlik.
lastChangedDate	string	Derlemenin son değiştirildiği tarih.
logs	BuildLogReference	Derleme günlükleri hakkında bilgi.
orchestrationPlan	TaskOrchestrationPlanReference	Derleme için düzenleme planı.
parameters	string	Derlemenin parametreleri.
plans	TaskOrchestrationPlanReference[]	Derlemeyle ilişkili düzenleme planları (derleme, temizleme)
priority	QueuePriority	Derlemenin önceliği.
project	TeamProjectReference	Takım projesi.
properties	PropertiesCollection	sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik çantasını temsil eder. Dışındaki `DBNull` tüm ilkel türlerin (ile herhangi bir `TypeCode != TypeCode.Object`tür) değerleri kabul edilir. Byte[], Int32, Double, DateType ve String türündeki değerler türlerini korur, diğer temel öğeler Dize olarak retuned edilir. Byte[] base64 kodlanmış dize olarak bekleniyor.
quality	string	xaml derlemesinin kalitesi (iyi, kötü vb.)
queue	AgentPoolQueue	Kuyruk. Bu yalnızca tanım türü Build ise ayarlanır. UYARI: Bu alan kullanım dışıdır ve iş kuyruklarına karşılık gelmez.
queueOptions	QueueOptions	Derlemeyi kuyruğa alma için ek seçenekler.
queuePosition	integer	Derlemenin kuyruktaki geçerli konumu.
queueTime	string	Derlemenin kuyruğa alındığı zaman.
reason	BuildReason	Derlemenin oluşturulma nedeni.
repository	BuildRepository	Depo.
requestedBy	IdentityRef	Derlemeyi kuyruğa alan kimlik.
requestedFor	IdentityRef	Derlemenin adına kuyruğa alınan kimlik.
result	BuildResult	Derleme sonucu.
retainedByRelease	boolean	Derlemenin bir sürüm tarafından korunup korunmadığını gösterir.
sourceBranch	string	Kaynak dal.
sourceVersion	string	Kaynak sürüm.
startTime	string	Derlemenin başlatıldığı saat.
status	BuildStatus	Derlemenin durumu.
tags	string[]
templateParameters	object	Şablon ifadesi değerlendirmesine yönelik parametreler
triggerInfo	object	Derlemeyi neyin tetiklediği hakkında sourceprovider'a özgü bilgiler
triggeredByBuild	Build	Derleme tamamlama tetikleyicisi aracılığıyla bu derlemeyi tetikleyen derleme.
uri	string	Derlemenin URI'sini.
url	string	Derlemenin REST URL'si.
validationResults	BuildRequestValidationResult[]	Derleme isteğini doğrulamanın sonucunu temsil eder.

BuildController

Name	Tür	Description
_links	ReferenceLinks	REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
createdDate	string	Denetleyicinin oluşturulduğu tarih.
description	string	Denetleyicinin açıklaması.
enabled	boolean	Denetleyicinin etkinleştirilip etkinleştirilmediğini gösterir.
id	integer	Kaynağın kimliği
name	string	Bağlı kaynağın adı (tanım adı, denetleyici adı vb.)
status	ControllerStatus	Denetleyicinin durumu.
updatedDate	string	Denetleyicinin son güncelleştirildiği tarih.
uri	string	Denetleyicinin URI'sini.
url	string	Kaynağa tam http bağlantısı

BuildLogReference

Derleme günlüğüne yapılan başvuruları temsil eder.

Name	Tür	Description
id	integer	Günlüğün kimliği.
type	string	Günlük konumunun türü.
url	string	Günlük kaynağının tam bağlantısı.

BuildReason

Derlemenin oluşturulma nedeni.

Name	Tür	Description
all	string	Tüm sebepler.
batchedCI	string	TriggerType.BatchedContinuousIntegration tetikleyicisi için derleme başlatıldı.
buildCompletion	string	Derleme, başka bir derleme tamamlandığında başlatıldı.
checkInShelveset	string	ContinuousIntegrationType.Gated tetikleyicisi için derleme başlatıldı.
individualCI	string	TriggerType.ContinuousIntegration tetikleyicisi için derleme başlatıldı.
manual	string	Derleme el ile başlatıldı.
none	string	Sebep yok. Bu değer kullanılmamalıdır.
pullRequest	string	Derleme bir çekme isteği tarafından başlatıldı. Kaynak sürüm 3'te eklendi.
resourceTrigger	string	Derleme, işlem hattındaki kaynaklar tarafından tetiklendiğinde başlatıldı
schedule	string	TriggerType.Schedule tetikleyicisi için derleme başlatıldı.
scheduleForced	string	TriggerType.ScheduleForced tetikleyicisi için derleme başlatıldı.
triggered	string	Derleme, bekletme ilkesi amacıyla tetiklendi.
userCreated	string	Derleme bir kullanıcı tarafından oluşturuldu.
validateShelveset	string	Derleme özel doğrulama için el ile başlatıldı.

BuildRepository

Derleme tanımı tarafından kullanılan bir deposunu temsil eder.

Name	Tür	Description
checkoutSubmodules	boolean	Alt modüllerin kullanıma alıp almayacağını gösterir.
clean	string	Depodan kod alırken hedef klasörün temizlenip temizlenmeyeceğini gösterir.
defaultBranch	string	Varsayılan dalın adı.
id	string	Deponun kimliği.
name	string	Deponun kolay adı.
properties	object
rootFolder	string	Kök klasör.
type	string	Deponun türü.
url	string	Deponun URL'si.

BuildRequestValidationResult

Derleme isteğini doğrulamanın sonucunu temsil eder.

Name	Tür	Description
message	string	Sonuçla ilişkili ileti.
result	ValidationResult	Sonuç.

BuildResult

Derleme sonucu.

Name	Tür	Description
canceled	string	Derleme başlamadan önce iptal edildi.
failed	string	Derleme başarısız bir şekilde tamamlandı.
none	string	Sonuç yok
partiallySucceeded	string	Derleme başarıyla tamamlandı, ancak başka hatalar vardı.
succeeded	string	Derleme başarıyla tamamlandı.

BuildStatus

Derleme durumu.

Name	Tür	Description
all	string	Tüm durum.
cancelling	string	Derleme iptal ediyor
completed	string	Derleme tamamlandı.
inProgress	string	Derleme şu anda devam ediyor.
none	string	Durum yok.
notStarted	string	Derleme henüz başlamadı.
postponed	string	Derleme kuyrukta etkin değil.

ControllerStatus

Denetleyicinin durumu.

Name	Tür	Description
available	string	Derleme denetleyicisinin şu anda kullanılabilir olduğunu gösterir.
offline	string	Derleme denetleyicisinin kendisini çevrimdışına aldığını gösterir.
unavailable	string	Derleme denetleyicisiyle bağlantı kurulamadığını gösterir.

DefinitionQueueStatus

Derlemelerin bu tanıma göre kuyruğa alınıp alınamayacağını gösteren bir değer.

Name	Tür	Description
disabled	string	Tanım kuyruğu devre dışı bırakıldığında derlemelerin kullanıcılar tarafından kuyruğa alınmasına izin vermez ve sistem zamanlanmış, geçitli veya sürekli tümleştirme derlemelerini kuyruğa almaz. Zaten kuyrukta olan derlemeler sistem tarafından başlatılmaz.
enabled	string	Tanım kuyruğu etkinleştirildiğinde derlemelerin kullanıcılar tarafından kuyruğa alınmasına izin verir, sistem zamanlanmış, geçitli ve sürekli tümleştirme derlemelerini kuyruğa alır ve kuyruğa alınan derlemeler sistem tarafından başlatılır.
paused	string	Tanım kuyruğu duraklatıldığında derlemelerin kullanıcılar tarafından kuyruğa alınmasına izin verir ve sistem zamanlanmış, geçitli ve sürekli tümleştirme derlemelerini kuyruğa alır. Kuyruktaki derlemeler sistem tarafından başlatılmaz.

DefinitionReference

Bir tanımın başvurularını temsil eder.

Name	Tür	Description
createdDate	string	Tanımın bu sürümünün oluşturulduğu tarih.
id	integer	Başvuruda bulunılan tanımın kimliği.
name	string	Başvuruda bulunan tanımın adı.
path	string	Tanımın klasör yolu.
project	TeamProjectReference	Projeye başvuru.
queueStatus	DefinitionQueueStatus	Derlemelerin bu tanıma göre kuyruğa alınıp alınamayacağını gösteren bir değer.
revision	integer	Tanım düzeltme numarası.
type	DefinitionType	Tanımın türü.
uri	string	Tanımın URI'sini.
url	string	Tanımın REST URL'si.

DefinitionType

Tanımın türü.

Name	Tür	Description
build	string
xaml	string

Demand

Bir tanım veya derleme tarafından kullanılan bir talebi temsil eder.

Name	Tür	Description
name	string	Talep tarafından başvuruda bulunan özelliğin adı.
value	string	Talep edilen değer.

IdentityRef

Name	Tür	Description
_links	ReferenceLinks	Bu alan, grafik konusu hakkında sıfır veya daha fazla ilgi çekici bağlantı içerir. Bu bağlantılar, bu grafik konusu hakkında daha fazla ilişki veya daha ayrıntılı bilgi edinmek için çağrılabilir.
descriptor	string	Tanımlayıcı, sistem çalışırken graf konusuna başvurmanın birincil yoludur. Bu alan, hem Hesaplar hem de Kuruluşlar genelinde aynı graf konusunu benzersiz olarak tanımlar.
directoryAlias	string	Kullanım dışı - IdentityRef "_links" sözlüğündeki "self" girişinde başvuruda bulunılan Graph kullanıcısı sorgulanarak alınabilir
displayName	string	Bu, grafik konusunun benzersiz olmayan görünen adıdır. Bu alanı değiştirmek için kaynak sağlayıcıdaki değerini değiştirmeniz gerekir.
id	string
imageUrl	string	Kullanım dışı - IdentityRef "_links" sözlüğün "avatar" girişinde kullanılabilir
inactive	boolean	Kullanım dışı - GraphUser "_links" sözlüğün "membershipState" girişinde başvurulan Graph üyelik durumu sorgulanarak alınabilir
isAadIdentity	boolean	Kullanım dışı - Tanımlayıcının konu türünden çıkarılabilir (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Kullanım dışı - Tanımlayıcının konu türünden çıkarılabilir (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Kullanım dışı - ToIdentityRef'in önceden var olan uygulamalarının çoğunda kullanımda değil
uniqueName	string	Kullanım dışı - bunun yerine Domain+PrincipalName kullanın
url	string	Bu URL, bu grafik konusunun kaynak kaynağına giden tam yoldur.

ProjectState

Proje durumu.

Name	Tür	Description
all	string	Durumu ne olursa olsun, Silinmiş dışındaki tüm projeler.
createPending	string	Project oluşturma için kuyruğa alındı, ancak işlem henüz başlamadı.
deleted	string	Proje silindi.
deleting	string	Project silinme aşamasında.
new	string	Project oluşturulma aşamasındadır.
unchanged	string	Proje değiştirilmedi.
wellFormed	string	Proje tamamen oluşturuldu ve kullanıma hazır.

ProjectVisibility

Proje görünürlüğü.

Name	Tür	Description
private	string	Proje yalnızca açık erişimi olan kullanıcılar tarafından görülebilir.
public	string	Proje herkes tarafından görülebilir.

PropertiesCollection

sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik çantasını temsil eder. Dışındaki DBNull tüm ilkel türlerin (ile herhangi bir TypeCode != TypeCode.Objecttür) değerleri kabul edilir. Byte[], Int32, Double, DateType ve String türündeki değerler türlerini korur, diğer temel öğeler Dize olarak retuned edilir. Byte[] base64 kodlanmış dize olarak bekleniyor.

Name	Tür	Description
count	integer	Koleksiyondaki özelliklerin sayısı.
item	object
keys	string[]	Koleksiyondaki anahtar kümesi.
values	string[]	Koleksiyondaki değer kümesi.

QueueOptions

Derlemeyi kuyruğa alma için ek seçenekler.

Name	Tür	Description
doNotRun	string	Derleme için plan kimliği oluşturun, çalıştırmayın
none	string	Kuyruk seçeneği yok

QueuePriority

Derlemenin önceliği.

Name	Tür	Description
aboveNormal	string	Normal önceliğin üzerinde.
belowNormal	string	Normal önceliğin altında.
high	string	Yüksek öncelikli.
low	string	Düşük öncelikli.
normal	string	Normal öncelik.

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

Name	Tür	Description
links	object	Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak göstermek istiyoruz.

TaskAgentPoolReference

Aracı havuzu başvurularını temsil eder.

Name	Tür	Description
id	integer	Havuz kimliği.
isHosted	boolean	Bu havuzun hizmet tarafından yönetilip yönetilmediğini belirten bir değer.
name	string	Havuz adı.

TaskOrchestrationPlanReference

Düzenleme planı başvurularını temsil eder.

Name	Tür	Description
orchestrationType	integer	Planın türü.
planId	string	Planın kimliği.

TeamProjectReference

TeamProject'e basit bir başvuru temsil eder.

Name	Tür	Description
abbreviation	string	Proje kısaltması.
defaultTeamImageUrl	string	Varsayılan ekip kimliği görüntüsünün URL'si.
description	string	Projenin açıklaması (varsa).
id	string	Proje tanımlayıcısı.
lastUpdateTime	string	Proje son güncelleştirme zamanı.
name	string	Proje adı.
revision	integer	Proje düzeltmesi.
state	ProjectState	Proje durumu.
url	string	Nesnenin tam sürümünün URL'si.
visibility	ProjectVisibility	Proje görünürlüğü.

ValidationResult

Sonuç.

Name	Tür	Description
error	string
ok	string
warning	string

Aracılığıyla paylaş