experiments
experiments API, 엔드포인트 12개 (자동 생성)
MLflow 실험, 실행(run), 실행 비교, 지표 시계열 및 실행 등록.
GET /api/v1/experiments/tree
GET/api/v1/experiments/tree
프로젝트 -> 실험 -> 실행(run) 트리
호출자의 테넌트로 범위가 한정된 프로젝트 -> 실험 -> 실행(run) 계층 구조를 반환합니다(화면 2).
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
max_runs | query | integer |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/runs/compare
GET/api/v1/runs/compare
여러 실행(run) 비교
여러 실행(run)의 파라미터와 지표를 나란히 비교합니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
run_ids | query | string | ✓ | 쉼표로 구분된 run id 목록 |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/runs/{run_id}
GET/api/v1/runs/{run_id}
실행(run) 상세
단일 실행(run)에 대한 전체 MLflow 상세 객체를 반환합니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
run_id | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
DELETE /api/v1/runs/{run_id}
DELETE/api/v1/runs/{run_id}
실행(run) 영구 삭제
실행(run)을 지표·파라미터·아티팩트까지 영구 삭제합니다.
필요 권한: DEVELOP
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
run_id | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 204 | Successful Response |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/runs/{run_id}/metrics/{name}
GET/api/v1/runs/{run_id}/metrics/{name}
지표 시계열
실행(run)의 단일 지표에 대해 기록된 시계열을 반환합니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
run_id | path | string | ✓ | |
name | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/runs/{run_id}/artifacts
GET/api/v1/runs/{run_id}/artifacts
실행(run) 아티팩트 목록
실행(run)의 아티팩트를 path 바로 아래 한 단계만 나열합니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
run_id | path | string | ✓ | |
path | query | string | 기준 디렉터리(루트는 빈 문자열) |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/runs/{run_id}/artifact
GET/api/v1/runs/{run_id}/artifact
실행(run) 아티팩트 내용/다운로드
단일 아티팩트 파일의 바이트를 스트리밍합니다(프리뷰/다운로드 공용).
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
run_id | path | string | ✓ | |
path | query | string | ✓ | 아티팩트 파일 경로(run 루트 기준) |
download | query | boolean | true면 attachment로 강제 다운로드 |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/runs/{run_id}/artifacts/download
GET/api/v1/runs/{run_id}/artifacts/download
실행(run) 아티팩트 일괄 다운로드
path 아래 아티팩트를 zip 하나로 묶어 내려보냅니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
run_id | path | string | ✓ | |
path | query | string | 묶을 디렉터리(루트 전체는 빈 문자열) |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/experiments
POST/api/v1/experiments
실험 생성
호출자의 테넌트를 위해 지정한 프로젝트 아래에 새 실험을 생성합니다.
필요 권한: DEVELOP
요청 본문: application/json, ExperimentCreate
| 필드 | 형식 | 필수 | 설명 |
|---|---|---|---|
name | string | ✓ | Name |
project | string | Project |
응답
| 상태 | 설명 |
|---|---|
| 201 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/runs/{run_id}/register
POST/api/v1/runs/{run_id}/register
실행(run) 등록
실행(run)의 아티팩트를 model_name 아래의 모델 레지스트리로 등록합니다.
필요 권한: MODEL_REGISTER
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
run_id | path | string | ✓ |
요청 본문: application/json, RegisterRequest
| 필드 | 형식 | 필수 | 설명 |
|---|---|---|---|
model_name | string | ✓ | Model Name |
응답
| 상태 | 설명 |
|---|---|
| 201 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/runs/{run_id}/terminate
POST/api/v1/runs/{run_id}/terminate
실행 중인 실행(run) 종료
활성 실행(run)을 종료(kill)합니다.
필요 권한: DEVELOP
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
run_id | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
DELETE /api/v1/experiments/{experiment_id}
DELETE/api/v1/experiments/{experiment_id}
실험 영구 삭제
실험과 그 아래 모든 실행(run)·아티팩트를 영구 삭제합니다.
필요 권한: DEVELOP
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
experiment_id | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 204 | Successful Response |
| 422 | Validation Error (HTTPValidationError) |