Aracılığıyla paylaş


Builds - Queue

Derlemeyi kuyruğa alır

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 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.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.

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.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.

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.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.

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.

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