Leases - Add

Service:

Build

API Version:

7.1-preview.2

İşlem hattı çalıştırmaları için yeni kiralar ekler.

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

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.2' olarak ayarlanmalıdır.

İstek Gövdesi

Name	Tür	Description
body	NewRetentionLease[]

Yanıtlar

Name	Tür	Description
200 OK	RetentionLease[]	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
NewRetentionLease	Yeni bir bekletme kiralaması oluşturmak için gerekli bilgiler.
RetentionLease	Geçerli bir bekletme kiralaması, otomatik sistemlerin işlem hattı çalıştırmasını silmesini engeller.

NewRetentionLease

Yeni bir bekletme kiralaması oluşturmak için gerekli bilgiler.

Name	Tür	Description
daysValid	integer	Kiranın geçerli olduğu düşünülecek gün sayısı. 100 yıldan fazla (36500 gün) için geçerli olan bir bekletme kirası, derlemeyi "sonsuza dek" olarak korur.
definitionId	integer	Çalıştırmanın işlem hattı tanımı.
ownerId	string	Bir bekletme kirasının sahibini tanımlayan kullanıcı tarafından sağlanan dize.
protectPipeline	boolean	Ayarlanırsa, bu kira, kiralama hala geçerliyken işlem hattının silinmesini de engeller.
runId	integer	Korumak için işlem hattı çalıştırılır.

RetentionLease

Geçerli bir bekletme kiralaması, otomatik sistemlerin işlem hattı çalıştırmasını silmesini engeller.

Name	Tür	Description
createdOn	string	Kira oluşturulduğunda.
definitionId	integer	Çalıştırmanın işlem hattı tanımı.
leaseId	integer	Bu kiralamanın benzersiz tanımlayıcısı.
ownerId	string	Bekletme kirasının sahibini tanımlayan benzersiz olmayan dize.
protectPipeline	boolean	Ayarlanırsa, bu kira, kiralama hala geçerliyken işlem hattının silinmesini de engeller.
runId	integer	İşlem hattı bu kiralama tarafından korunan bir çalıştırmadır.
validUntil	string	Kiranın geçerli olduğu son gün.