Udostępnij za pośrednictwem


Leases - Get

Zwraca szczegóły dzierżawy przechowywania dla danego identyfikatora dzierżawy.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
leaseId
path True

integer

int32
organization
path True

string

Nazwa organizacji usługi Azure DevOps.

project
path True

string

Identyfikator projektu lub nazwa projektu

api-version
query True

string

Wersja interfejsu API do użycia. Ta wartość powinna mieć wartość "7.1-preview.2", aby używać tej wersji interfejsu API.

Odpowiedzi

Nazwa Typ Opis
200 OK

RetentionLease

operacja zakończona powodzeniem

Zabezpieczenia

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

Nazwa Opis
vso.build Umożliwia dostęp do artefaktów kompilacji, w tym wyników kompilacji, definicji i żądań oraz możliwość odbierania powiadomień o zdarzeniach kompilacji za pośrednictwem punktów zaczepienia usługi.

Definicje

RetentionLease

Prawidłowa dzierżawa przechowywania uniemożliwia automatycznym systemom usuwanie uruchomienia potoku.

Nazwa Typ Opis
createdOn

string

Po utworzeniu dzierżawy.

definitionId

integer

Definicja potoku przebiegu.

leaseId

integer

Unikatowy identyfikator tej dzierżawy.

ownerId

string

Ciąg inny niż unikatowy, który identyfikuje właściciela dzierżawy przechowywania.

protectPipeline

boolean

Jeśli ta dzierżawa zostanie ustawiona, uniemożliwi również usunięcie potoku, gdy dzierżawa jest nadal prawidłowa.

runId

integer

Uruchomienie potoku chronionego przez tę dzierżawę.

validUntil

string

Ostatni dzień dzierżawy jest uznawany za prawidłowy.