Leases - Add

Service:

Build

API Version:

7.1-preview.2

파이프라인 실행에 대한 새 임대를 추가합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
organization	path	True	string	Azure DevOps 조직의 이름입니다.
project	path	True	string	프로젝트 ID 또는 프로젝트 이름
api-version	query	True	string	사용할 API의 버전입니다. 이 API 버전을 사용하려면 '7.1-preview.2'로 설정해야 합니다.

요청 본문

Name	형식	Description
body	NewRetentionLease[]

응답

Name	형식	Description
200 OK	RetentionLease[]	성공적인 작업

보안

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	빌드 결과, 정의 및 요청을 비롯한 빌드 아티팩트 액세스 기능과 빌드 큐에 대기하고, 빌드 속성을 업데이트하고, 서비스 후크를 통해 빌드 이벤트에 대한 알림을 받을 수 있는 기능을 부여합니다.

정의

Name	Description
NewRetentionLease	새 보존 임대를 만드는 데 필요한 정보입니다.
RetentionLease	유효한 보존 임대는 자동화된 시스템이 파이프라인 실행을 삭제하는 것을 방지합니다.

NewRetentionLease

새 보존 임대를 만드는 데 필요한 정보입니다.

Name	형식	Description
daysValid	integer	임대를 유효한 것으로 간주할 일 수입니다. 100년(36500일) 이상 유효한 보존 임대는 빌드를 "영원히" 보존하는 것으로 표시됩니다.
definitionId	integer	실행의 파이프라인 정의입니다.
ownerId	string	보존 임대의 소유자를 식별하는 사용자가 제공한 문자열입니다.
protectPipeline	boolean	이 임대를 설정하면 임대가 여전히 유효한 동안 파이프라인이 삭제되지 않습니다.
runId	integer	파이프라인을 실행하여 보호합니다.

RetentionLease

유효한 보존 임대는 자동화된 시스템이 파이프라인 실행을 삭제하는 것을 방지합니다.

Name	형식	Description
createdOn	string	임대를 만든 경우.
definitionId	integer	실행의 파이프라인 정의입니다.
leaseId	integer	이 임대의 고유 식별자입니다.
ownerId	string	보존 임대의 소유자를 식별하는 고유하지 않은 문자열입니다.
protectPipeline	boolean	이 임대를 설정하면 임대가 여전히 유효한 동안 파이프라인이 삭제되지 않습니다.
runId	integer	이 임대로 보호되는 파이프라인 실행입니다.
validUntil	string	임대가 유효한 것으로 간주되는 마지막 날입니다.