빌드와 실행 작업의 응답 모델
Build는 여러 실행 작업을 조정하는 빌드 전체의 상태를, Job은 입력에서 하나 이상의 출력을 계산하는 개별 실행 작업의 상태를 나타냅니다. 빌드와 실행 작업의 상태 열거값을 구분합니다.
Build
finishedTime은 실행 중인 빌드에서 비어 있습니다. scheduleRid는 스케줄이 시작한 빌드에 있으며 사용자가 직접 시작한 빌드에서는 비어 있습니다. fallbackBranches는 JobSpec을 찾을 다른 브랜치 목록으로, 데이터 조회의 임의 대체 규칙으로 해석하지 않습니다.
retryCount는 실패한 실행 작업의 재시도 설정입니다. 재시도를 모두 사용하거나 재시도할 수 없는 오류가 발생하기 전까지 실패를 최종 확정하지 않습니다. retryBackoffDuration은 재시도 대기 시간이며 모든 실패를 재시도할 수 있는 것은 아닙니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
rid | string | 필수 | 빌드의 RID입니다. | ri.foundry.main.build.a4386b7e-d546-49be-8a36-eefc355f5c58 |
branchName | string | 필수 | 빌드가 실행되는 브랜치입니다. | master |
createdTime | string (date-time) | 필수 | 빌드가 생성된 시각입니다. | 2003-05-06T12:34:56.789Z |
createdBy | string | 필수 | 빌드를 생성한 사용자입니다. | f05f8da4-b84c-4fca-9c77-8af0b13d11de |
fallbackBranches | list<BranchName> | 선택 | 대상 브랜치에서 JobSpec을 찾지 못했을 때 실행 작업 명세를 조회할 다른 브랜치 목록입니다. | 응답 예시 참조 |
jobRids | list<JobRid> | 선택 | ||
retryCount | integer | 필수 | 빌드 안에서 실패한 실행 작업을 재시도할 횟수입니다. 모든 재시도를 사용했거나 재시도할 수 없는 오류가 발생하기 전까지 실패를 최종 확정하지 않습니다. 모든 종류의 실패를 재시도할 수 있는 것은 아닙니다. | 1 |
retryBackoffDuration | object | 필수 | 실행 작업 실패 후 다음 재시도까지 기다릴 기간입니다. | 응답 예시 참조 |
abortOnFailure | boolean | 필수 | 활성화하면 실행 작업 하나가 성공하지 못한 결과로 끝날 때 나머지 작업을 취소하여 빌드를 즉시 종료합니다. | false |
status | enum | 필수 | 빌드 상태입니다. 허용값: RUNNING, SUCCEEDED, FAILED, CANCELED. | RUNNING |
finishedTime | string (date-time) | 선택 | 빌드 처리가 끝난 시각입니다. 실행 중에는 값이 없습니다. | 2003-05-06T12:34:56.789Z |
scheduleRid | string | 선택 | 빌드를 시작한 스케줄의 RID입니다. 사용자가 직접 시작한 빌드에서는 값이 없습니다. | ri.scheduler.main.schedule.5ad5c340-59f3-4a60-9fc6-161bb984f871 |
fallbackBranches의 구조
배열 항목은 BranchName이며 자료형은 string입니다.
브랜치 이름입니다.
jobRids의 구조
배열 항목은 JobRid이며 자료형은 string입니다.
실행 작업의 RID입니다.
retryBackoffDuration의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
value | integer | 필수 | 기간의 수치입니다. | 30 |
unit | enum | 필수 | 기간의 단위입니다. 허용값: MILLISECONDS, SECONDS, MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS. | SECONDS |
Job
startedTime은 의존 관계를 기다리기 시작한 시각입니다. 실제 최근 시도의 실행 시작은 latestAttemptStartTime이며, 시작에 실패하면 없거나 이전 값일 수 있습니다.
outputs에는 API가 지원하는 데이터셋과 미디어 집합 출력만 들어 있습니다. 다른 출력 유형이 생략될 수 있으므로 이 목록을 모든 가능한 출력의 전체 목록으로 해석하지 않습니다. 데이터셋 출력의 트랜잭션 RID와 미디어 집합 출력의 트랜잭션 ID도 구분합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
rid | string | 필수 | 실행 작업의 RID입니다. | ri.foundry.main.job.aaf94076-d773-4732-a1df-3b638eb50448 |
buildRid | string | 필수 | 이 실행 작업이 속한 빌드의 RID입니다. | ri.foundry.main.build.a4386b7e-d546-49be-8a36-eefc355f5c58 |
startedTime | string (date-time) | 필수 | 의존 관계가 해결되기를 기다리기 시작한 시각입니다. | 2003-05-06T12:34:56.789Z |
latestAttemptStartTime | string (date-time) | 선택 | 최근 시도가 실제 실행을 시작한 시각입니다. 작업이 시작하지 못한 경우 값이 없거나 이전 값일 수 있습니다. | 2003-05-06T12:34:56.789Z |
finishedTime | string (date-time) | 선택 | 실행 작업이 끝난 시각입니다. | 2003-05-06T12:34:56.789Z |
jobStatus | enum | 필수 | 실행 작업 상태입니다. 허용값: WAITING, RUNNING, SUCCEEDED, FAILED, CANCELED, DID_NOT_RUN. | WAITING |
outputs | list<JobOutput> | 선택 | 실행 작업의 출력입니다. 이 API가 지원하는 데이터셋과 미디어 집합 출력만 포함하며 다른 출력 유형은 생략합니다. |
outputs의 구조
배열 항목은 JobOutput이며 자료형은 union<datasetJobOutput, transactionalMediaSetJobOutput>입니다.
Foundry에는 다른 실행 작업 출력 유형도 있지만 이 API는 데이터셋과 미디어 집합 출력만 지원합니다.
분기 datasetJobOutput
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: datasetJobOutput. | datasetJobOutput |
datasetRid | string | 필수 | 데이터셋의 RID입니다. | ri.foundry.main.dataset.c26f11c8-cdb3-4f44-9f5d-9816ea1c82da |
outputTransactionRid | string | 선택 | 트랜잭션의 RID입니다. | ri.foundry.main.transaction.0a0207cb-26b7-415b-bc80-66a3aa3933f4 |
분기 transactionalMediaSetJobOutput
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: transactionalMediaSetJobOutput. | transactionalMediaSetJobOutput |
mediaSetRid | string | 필수 | Foundry 미디어 집합의 RID입니다. | |
transactionId | string | 선택 | c24f22d9-aec4-4f55-9f5e-9316eb1c83aa |