images
images API, 엔드포인트 17개 (자동 생성)
GET /api/v1/images
GET/api/v1/images
테넌트의 모델 이미지 목록
테넌트의 모델 이미지 목록을 반환합니다(최신순).
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
model_name | query | string? | 모델 이름으로 필터 | |
model_version | query | string? | 모델 버전으로 필터 |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/images
POST/api/v1/images
모델 버전의 이미지 빌드 시작
등록 모델 버전 하나의 컨테이너 이미지 빌드를 시작합니다.
필요 권한: DEPLOY
요청 본문: application/json, BuildImageBody
| 필드 | 형식 | 필수 | 설명 |
|---|---|---|---|
model_name | string | ✓ | MLflow 등록 모델 이름 |
version | string | ✓ | MLflow 모델 버전 |
builder_tag | string? | 서빙 빌더 변형 태그(비우면 기본) |
응답
| 상태 | 설명 |
|---|---|
| 202 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/images/diagnostics
GET/api/v1/images/diagnostics
이미지 빌드 사전 진단
빌드를 시작하기 전에 막힐 이유가 있는지 알려 줍니다.
필요 권한: VIEW
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
GET /api/v1/images/model-check
GET/api/v1/images/model-check
빌드 전 모델 버전 점검
이 버전을 굽기 전에 알아 둘 문제가 있는지 알려 줍니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
model_name | query | string | ✓ | MLflow 등록 모델 이름 |
version | query | string | ✓ | MLflow 모델 버전 |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/images/builders
GET/api/v1/images/builders
서빙 빌더 변형 목록
이 테넌트의 변형 목록을 게시 상태와 함께 반환합니다.
필요 권한: VIEW
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
POST /api/v1/images/builders
POST/api/v1/images/builders
서빙 빌더 변형 생성
변형을 새로 만듭니다.
요청 본문: application/json, VariantCreate
| 필드 | 형식 | 필수 | 설명 |
|---|---|---|---|
name | string | ✓ | 표시명 |
tag | string | ✓ | 이미지 태그(불변) |
description | string | Description | |
build_args | object | Build Args | |
is_default | boolean | Is Default | |
image_ref | string? | Image Ref | |
framework | string? | Framework |
응답
| 상태 | 설명 |
|---|---|
| 201 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/images/builders/{variant_id}
GET/api/v1/images/builders/{variant_id}
서빙 빌더 변형 상세
변형 하나의 상세와 게시 상태를 반환합니다. VIEW 권한이 필요합니다.
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
variant_id | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
PATCH /api/v1/images/builders/{variant_id}
PATCH/api/v1/images/builders/{variant_id}
서빙 빌더 변형 수정
표시명·설명·build-arg 를 수정합니다(태그는 불변).
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
variant_id | path | string | ✓ |
요청 본문: application/json, VariantUpdate
| 필드 | 형식 | 필수 | 설명 |
|---|---|---|---|
name | string? | Name | |
description | string? | Description | |
build_args | object? | Build Args | |
image_ref | string? | Image Ref | |
framework | string? | Framework |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
DELETE /api/v1/images/builders/{variant_id}
DELETE/api/v1/images/builders/{variant_id}
서빙 빌더 변형 삭제
변형을 삭제합니다.
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
variant_id | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/images/builders/{variant_id}/default
POST/api/v1/images/builders/{variant_id}/default
서빙 빌더 변형 기본 지정
이 변형을 기본으로 지정합니다(기존 기본은 해제).
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
variant_id | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/images/builders/{variant_id}/publish
POST/api/v1/images/builders/{variant_id}/publish
서빙 빌더 변형 게시 시작
이 변형의 이미지를 굽고 레지스트리에 게시합니다.
필요 권한: DEPLOY
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
variant_id | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 202 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
DELETE /api/v1/images/builders/{variant_id}/publish
DELETE/api/v1/images/builders/{variant_id}/publish
서빙 빌더 변형 게시 중지
진행 중인 게시 Job 을 중지합니다.
필요 권한: DEPLOY
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
variant_id | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/images/builders/{variant_id}/logs
GET/api/v1/images/builders/{variant_id}/logs
서빙 빌더 변형 게시 로그
현재/마지막 게시 Job 의 로그를 반환합니다. VIEW 권한이 필요합니다.
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
variant_id | path | string | ✓ | |
run_id | query | string? | 지난 게시 실행(Job 이름)을 지목해 보존 로그를 읽습니다 |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/images/builders/{variant_id}/logs/raw
GET/api/v1/images/builders/{variant_id}/logs/raw
서빙 빌더 변형 게시 로그 전문 내려받기
보존된 게시 로그 전문을 스트리밍합니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
variant_id | path | string | ✓ | |
run_id | query | string? | 지난 게시 실행(Job 이름). 비우면 현재 실행 |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/images/{image_id}
GET/api/v1/images/{image_id}
모델 이미지 상세
모델 이미지 하나의 상태를 반환합니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
image_id | path | string (uuid) | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/images/{image_id}/logs
GET/api/v1/images/{image_id}/logs
이미지 빌드 로그
빌드 Job 의 로그를 반환합니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
image_id | path | string (uuid) | ✓ | |
run_id | query | string? | 지난 빌드 실행(Job 이름)을 지목해 보존 로그를 읽습니다 |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/images/{image_id}/logs/raw
GET/api/v1/images/{image_id}/logs/raw
이미지 빌드 로그 전문 내려받기
보존된 빌드 로그 전문을 스트리밍합니다.
필요 권한: VIEW
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
image_id | path | string (uuid) | ✓ | |
run_id | query | string? | 지난 빌드 실행(Job 이름). 비우면 현재 실행 |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |