Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

빌드 API (V2)

Build는 Foundry 데이터셋의 새 버전을 계산하는 실행 단위입니다. 여러 실행 작업을 조정하여 입력에서 출력을 계산합니다. 실행 작업 명세와 출력 처리의 개념은 빌드와 실행 작업을 따릅니다.

실행과 조회

Create Build에 빌드 대상과 실행 설정을 전달합니다. 대상은 직접 지정, 상위 데이터셋 포함 또는 입력과 대상 사이의 범위 중 하나를 선택합니다.

생성 응답이나 Get Build의 상태는 RUNNING, SUCCEEDED, FAILED, CANCELED 중 하나입니다. 실제 개별 실행 작업은 빌드의 작업 목록으로 확인합니다. 여러 빌드를 조회할 때는 최대 100개의 일괄 조회를 사용할 수 있습니다.

실행 중인 빌드에는 완료 시각이 없으며 직접 시작한 빌드에는 스케줄 RID가 없습니다. 전체 필드는 Build 응답 모델에 있습니다.

재시도와 취소

retryCount와 retryBackoffDuration은 빌드 안의 실패한 실행 작업에 적용합니다. API 요청 자체를 다시 보내는 설정이 아닙니다. 재시도할 수 없는 실패가 있으면 남은 횟수가 있어도 재시도할 수 없습니다.

Cancel Build는 미완료 작업의 취소를 비동기로 요청합니다. 성공 응답을 받았어도 실제 상태를 조회해야 합니다. 이미 끝났거나 취소 적용 전에 끝난 빌드는 바뀌지 않습니다.