Leases - Update

Service:

Build

API Version:

7.1-preview.2

Aktualizace dobu trvání nebo stav ochrany kanálu zapůjčení uchovávání informací.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
leaseId	path	True	integer int32	ID zapůjčení, které se má aktualizovat.
organization	path	True	string	Název organizace Azure DevOps.
project	path	True	string	ID projektu nebo název projektu
api-version	query	True	string	Verze rozhraní API, která se má použít. Tato verze rozhraní API by měla být nastavená na 7.1-preview.2.

Text požadavku

Name	Typ	Description
daysValid	integer	Počet dní, po který se má zapůjčení považovat za platné. Zapůjčení uchovávání informací platné po dobu delší než 100 let (36 500 dnů) se zobrazí jako zachování buildu "navždy".
protectPipeline	boolean	Pokud je toto zapůjčení nastavené, zabrání také odstranění kanálu v době, kdy je zapůjčení stále platné.

Odpovědi

Name	Typ	Description
200 OK	RetentionLease	úspěšná operace

Zabezpečení

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	Uděluje možnost přistupovat k artefaktům sestavení, včetně výsledků sestavení, definic a požadavků, a možnost zařadit sestavení do fronty, aktualizovat vlastnosti sestavení a přijímat oznámení o událostech sestavení prostřednictvím hooků služeb.

Definice

Name	Description
RetentionLease	Platné zapůjčení uchovávání informací zabraňuje automatizovaným systémům odstranit spuštění kanálu.
RetentionLeaseUpdate	Aktualizace parametrů uchovávání informací zapůjčení uchovávání informací.

RetentionLease

Platné zapůjčení uchovávání informací zabraňuje automatizovaným systémům odstranit spuštění kanálu.

Name	Typ	Description
createdOn	string	Kdy bylo zapůjčení vytvořeno.
definitionId	integer	Definice kanálu spuštění.
leaseId	integer	Jedinečný identifikátor pro toto zapůjčení.
ownerId	string	Ne jedinečný řetězec, který identifikuje vlastníka zapůjčení uchovávání informací.
protectPipeline	boolean	Pokud je toto zapůjčení nastavené, zabrání také odstranění kanálu v době, kdy je zapůjčení stále platné.
runId	integer	Kanál běží chráněný tímto zapůjčením.
validUntil	string	Poslední den zapůjčení se považuje za platné.

RetentionLeaseUpdate

Aktualizace parametrů uchovávání informací zapůjčení uchovávání informací.

Name	Typ	Description
daysValid	integer	Počet dní, po který se má zapůjčení považovat za platné. Zapůjčení uchovávání informací platné po dobu delší než 100 let (36 500 dnů) se zobrazí jako zachování buildu "navždy".
protectPipeline	boolean	Pokud je toto zapůjčení nastavené, zabrání také odstranění kanálu v době, kdy je zapůjčení stále platné.