Leases - Update

Service:

Build

API Version:

7.1-preview.2

Bekletme kiralamasının süresini veya işlem hattı koruma durumunu Güncelleştirmeler.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
leaseId	path	True	integer int32	Güncelleştirilecek kiranın kimliği.
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
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.
protectPipeline	boolean	Ayarlanırsa, bu kira, kiralama hala geçerliyken işlem hattının silinmesini de engeller.

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
RetentionLease	Geçerli bir bekletme kiralaması, otomatik sistemlerin işlem hattı çalıştırmasını silmesini engeller.
RetentionLeaseUpdate	Bekletme kiralamasının bekletme parametrelerine yönelik güncelleştirme.

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.

RetentionLeaseUpdate

Bekletme kiralamasının bekletme parametrelerine yönelik güncelleştirme.

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.
protectPipeline	boolean	Ayarlanırsa, bu kira, kiralama hala geçerliyken işlem hattının silinmesini de engeller.