Leases - Get Retention Leases By Minimal Retention Leases
Gibt alle Leases zurück, die den angegebenen MinimalRetentionLeases entsprechen
GET https://dev.azure.com/{organization}/{project}/_apis/build/retention/leases?leasesToFetch={leasesToFetch}&api-version=7.1-preview.2URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
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. |
|
leases
|
query | True |
string array (MinimalRetentionLease) |
Liste der JSON-serialisierten MinimalRetentionLeases, die durch "|" getrennt sind |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
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. |