Leases - Get

Service:

Build

API Version:

7.1-preview.2

Gibt die Details der Aufbewahrungsleasase unter Angabe einer Lease-ID zurück.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
leaseId	path	True	integer int32
organization	path	True	string	Der Name der Azure DevOps-Organisation.
project	path	True	string	Projekt-ID oder Projektname
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1-preview.2" festgelegt werden, um diese Version der API zu verwenden.

Antworten

Name	Typ	Beschreibung
200 OK	RetentionLease	Erfolgreicher Vorgang

Sicherheit

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	Beschreibung
vso.build	Ermöglicht den Zugriff auf Buildartefakte, einschließlich Buildergebnissen, Definitionen und Anforderungen, und die Möglichkeit, Benachrichtigungen über Buildereignisse über Diensthaken zu empfangen.

Definitionen

RetentionLease

Eine gültige Aufbewahrungsleasase verhindert, dass automatisierte Systeme eine Pipelineausführung löschen.

Name	Typ	Beschreibung
createdOn	string	Wann die Lease erstellt wurde.
definitionId	integer	Die Pipelinedefinition der Ausführung.
leaseId	integer	Der eindeutige Bezeichner für diese Lease.
ownerId	string	Nicht eindeutige Zeichenfolge, die den Besitzer einer Aufbewahrungsleases identifiziert.
protectPipeline	boolean	Wenn festgelegt, verhindert diese Lease, dass die Pipeline gelöscht wird, solange die Lease noch gültig ist.
runId	integer	Die Pipeline wird durch diese Lease geschützt ausgeführt.
validUntil	string	Der letzte Tag, an dem der Leasingvertrag gültig ist.