다음을 통해 공유


Leases - Add

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

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
organization
path True

string

Azure DevOps 조직의 이름입니다.

project
path True

string

프로젝트 ID 또는 프로젝트 이름

api-version
query True

string

사용할 API의 버전입니다. 이 버전의 API를 사용하려면 '7.1'로 설정해야 합니다.

요청 본문

Name 형식 Description
body

NewRetentionLease[]

응답

Name 형식 Description
200 OK

RetentionLease[]

성공한 작업

보안

oauth2

형식: oauth2
Flow: accessCode
권한 부여 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
토큰 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

범위

Name Description
vso.build_execute 빌드 결과, 정의 및 요청을 포함하여 빌드 아티팩트 액세스 기능과 빌드를 큐에 대기하고 빌드 속성을 업데이트하며 서비스 후크를 통해 빌드 이벤트에 대한 알림을 받을 수 있는 기능을 부여합니다.

정의

Name Description
NewRetentionLease

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

RetentionLease

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

NewRetentionLease

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

Name 형식 Description
daysValid

integer (int32)

임대를 유효한 것으로 간주할 일 수입니다. 100년(36500일) 이상 유효한 보존 임대는 빌드를 "영원히" 보존하는 것으로 표시됩니다.

definitionId

integer (int32)

실행의 파이프라인 정의입니다.

ownerId

string

보존 임대의 소유자를 식별하는 사용자가 제공한 문자열입니다.

protectPipeline

boolean

이 임대를 설정하면 임대가 여전히 유효한 동안 파이프라인이 삭제되지 않습니다.

runId

integer (int32)

보호할 파이프라인 실행입니다.

RetentionLease

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

Name 형식 Description
createdOn

string (date-time)

임대를 만든 경우입니다.

definitionId

integer (int32)

실행의 파이프라인 정의입니다.

leaseId

integer (int32)

이 임대의 고유 식별자입니다.

ownerId

string

보존 임대의 소유자를 식별하는 고유하지 않은 문자열입니다.

protectPipeline

boolean

이 임대를 설정하면 임대가 여전히 유효한 동안 파이프라인이 삭제되지 않습니다.

runId

integer (int32)

이 임대로 보호되는 파이프라인 실행입니다.

validUntil

string (date-time)

임대가 유효한 것으로 간주되는 마지막 날입니다.