Builds - Queue

Hizmet:

Build

API Sürümü:

7.1

Derlemeyi kuyruğa alır

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

İsteğe bağlı parametrelerle:

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

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'nin sürümü. Bu, API'nin bu sürümünü kullanmak için '7.1' olarak ayarlanmalıdır.
checkInTicket	query		string
definitionId	query		integer (int32)	Bir derlemeyi gövdesiz 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	Kullanıcı arabiriminde BuildNumber'a commit iletisi ekleyin.
buildNumber	string	Derlemenin derleme numarası/adı.
buildNumberRevision	integer (int32)	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 (date-time)	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 (date-time)	Derlemenin tamamlanma zamanı.
id	integer (int32)	Derlemenin kimliği.
lastChangedBy	IdentityRef	Derlemeyi en son değiştiren işlemi veya kişiyi temsil eden kimlik.
lastChangedDate	string (date-time)	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 paketini temsil eder. TypeCode != TypeCode.Object dışındaki tüm ilkel türlerin (DBNullolan herhangi bir 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 yeniden dönüştürülür. 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ü Derleme 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 (int32)	Derlemenin kuyruktaki geçerli konumu.
queueTime	string (date-time)	Derlemenin kuyruğa alındığı saat.
reason	BuildReason	Derlemenin oluşturulma nedeni.
repository	BuildRepository	Depo.
requestedBy	IdentityRef	Derlemeyi kuyruğa alan kimlik.
requestedFor	IdentityRef	Derlemenin kuyruğa alındığı kimliği.
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 (date-time)	Derlemenin başlatıldığı zaman.
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

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Belirteç URL'si: 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

Kapsamlar

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 paketini temsil eder. TypeCode != TypeCode.Object dışındaki tüm ilkel türlerin (DBNullolan herhangi bir 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 yeniden dönüştürülür. 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

Object

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 (int32)	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

Object

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

Object

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	Kullanıcı arabiriminde BuildNumber'a commit iletisi ekleyin.
buildNumber	string	Derlemenin derleme numarası/adı.
buildNumberRevision	integer (int32)	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 (date-time)	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 (date-time)	Derlemenin tamamlanma zamanı.
id	integer (int32)	Derlemenin kimliği.
lastChangedBy	IdentityRef	Derlemeyi en son değiştiren işlemi veya kişiyi temsil eden kimlik.
lastChangedDate	string (date-time)	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 paketini temsil eder. TypeCode != TypeCode.Object dışındaki tüm ilkel türlerin (DBNullolan herhangi bir 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 yeniden dönüştürülür. 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ü Derleme 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 (int32)	Derlemenin kuyruktaki geçerli konumu.
queueTime	string (date-time)	Derlemenin kuyruğa alındığı saat.
reason	BuildReason	Derlemenin oluşturulma nedeni.
repository	BuildRepository	Depo.
requestedBy	IdentityRef	Derlemeyi kuyruğa alan kimlik.
requestedFor	IdentityRef	Derlemenin kuyruğa alındığı kimliği.
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 (date-time)	Derlemenin başlatıldığı zaman.
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

Object

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

BuildLogReference

Object

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

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

BuildReason

Listeleme

Derlemenin oluşturulma nedeni.

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

BuildRepository

Object

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

Object

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

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

BuildResult

Listeleme

Derleme sonucu.

Değer	Description
canceled	Derleme başlamadan önce iptal edildi.
failed	Derleme başarısız bir şekilde tamamlandı.
none	Sonuç yok
partiallySucceeded	Derleme başarıyla tamamlandı ancak başka hatalar da vardı.
succeeded	Derleme başarıyla tamamlandı.

BuildStatus

Listeleme

Derleme durumu.

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

ControllerStatus

Listeleme

Denetleyicinin durumu.

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

DefinitionQueueStatus

Listeleme

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

Değer	Description
disabled	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	Tanım kuyruğu etkinleştirildiğinde derlemelerin kullanıcılar tarafından kuyruğa alınmasına izin vererek 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	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

Object

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

Name	Tür	Description
createdDate	string (date-time)	Tanımın bu sürümünün oluşturulduğu tarih.
id	integer (int32)	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 (int32)	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

Listeleme

Tanımın türü.

Değer	Description
build
xaml

Demand

Object

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

Object

Name	Tür	Description
_links	ReferenceLinks	Bu alan, grafik konusu hakkında sıfır veya daha fazla ilginç 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üğündeki "membershipState" girdisinde 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 (Tanımlayıcı.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

Listeleme

Proje durumu.

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

ProjectVisibility

Listeleme

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

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

PropertiesCollection

Object

sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik paketini temsil eder. TypeCode != TypeCode.Object dışındaki tüm ilkel türlerin (DBNullolan herhangi bir 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 yeniden dönüştürülür. Byte[] base64 kodlanmış dize olarak bekleniyor.

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

QueueOptions

Listeleme

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

Değer	Description
doNotRun	Derleme için plan kimliği oluşturun, çalıştırmayın
none	Kuyruk seçeneği yok

QueuePriority

Listeleme

Derlemenin önceliği.

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

ReferenceLinks

Object

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 kullanıma açmak istiyoruz.

TaskAgentPoolReference

Object

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

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

TaskOrchestrationPlanReference

Object

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

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

TeamProjectReference

Object

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 (uuid)	Proje tanımlayıcısı.
lastUpdateTime	string (date-time)	Proje son güncelleştirme zamanı.
name	string	Proje adı.
revision	integer (int64)	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

Listeleme

Sonuç.

Değer	Description
error
ok
warning