한국어

images

images API, 17 endpoints (generated)

GET /api/v1/images

GET/api/v1/images

테넌트의 모델 이미지 목록

테넌트의 모델 이미지 목록 반환(최신순).

Permission: VIEW

Parameters

NameInTypeRequiredDescription
model_namequerystring?모델 이름으로 필터
model_versionquerystring?모델 버전으로 필터

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/images

POST/api/v1/images

모델 버전의 이미지 빌드 시작

등록 모델 버전 하나의 컨테이너 이미지 빌드 시작.

Permission: DEPLOY

Request body: application/json, BuildImageBody

FieldTypeRequiredDescription
model_namestring✓MLflow 등록 모델 이름
versionstring✓MLflow 모델 버전
builder_tagstring?서빙 빌더 변형 태그(비우면 기본)

Responses

StatusDescription
202Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/images/diagnostics

GET/api/v1/images/diagnostics

이미지 빌드 사전 진단

빌드를 시작하기 전에 막힐 이유가 있는지 알림.

Permission: VIEW

Responses

StatusDescription
200Successful Response (object)

GET /api/v1/images/model-check

GET/api/v1/images/model-check

빌드 전 모델 버전 점검

이 버전을 빌드하기 전에 확인할 문제가 있는지 알림.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
model_namequerystring✓MLflow 등록 모델 이름
versionquerystring✓MLflow 모델 버전

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/images/builders

GET/api/v1/images/builders

서빙 빌더 변형 목록

이 테넌트의 변형 목록을 게시 상태와 함께 반환.

Permission: VIEW

Responses

StatusDescription
200Successful Response (object)

POST /api/v1/images/builders

POST/api/v1/images/builders

서빙 빌더 변형 생성

변형을 새로 생성.

Request body: application/json, VariantCreate

FieldTypeRequiredDescription
namestring✓표시명
tagstring✓이미지 태그(불변)
descriptionstringDescription
build_argsobjectBuild Args
is_defaultbooleanIs Default
image_refstring?Image Ref
frameworkstring?Framework

Responses

StatusDescription
201Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/images/builders/{variant_id}

GET/api/v1/images/builders/{variant_id}

서빙 빌더 변형 상세

변형 하나의 상세와 게시 상태 반환. VIEW 권한이 필요.

Parameters

NameInTypeRequiredDescription
variant_idpathstring✓

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

PATCH /api/v1/images/builders/{variant_id}

PATCH/api/v1/images/builders/{variant_id}

서빙 빌더 변형 수정

표시명·설명·build-arg 를 수정(태그는 불변).

Parameters

NameInTypeRequiredDescription
variant_idpathstring✓

Request body: application/json, VariantUpdate

FieldTypeRequiredDescription
namestring?Name
descriptionstring?Description
build_argsobject?Build Args
image_refstring?Image Ref
frameworkstring?Framework

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/images/builders/{variant_id}

DELETE/api/v1/images/builders/{variant_id}

서빙 빌더 변형 삭제

변형 삭제.

Parameters

NameInTypeRequiredDescription
variant_idpathstring✓

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/images/builders/{variant_id}/default

POST/api/v1/images/builders/{variant_id}/default

서빙 빌더 변형 기본 지정

이 변형을 기본으로 지정(기존 기본은 해제).

Parameters

NameInTypeRequiredDescription
variant_idpathstring✓

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/images/builders/{variant_id}/publish

POST/api/v1/images/builders/{variant_id}/publish

서빙 빌더 변형 게시 시작

이 변형의 이미지를 빌드하고 레지스트리에 게시.

Permission: DEPLOY

Parameters

NameInTypeRequiredDescription
variant_idpathstring✓

Responses

StatusDescription
202Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/images/builders/{variant_id}/publish

DELETE/api/v1/images/builders/{variant_id}/publish

서빙 빌더 변형 게시 중지

진행 중인 게시 Job 을 중지.

Permission: DEPLOY

Parameters

NameInTypeRequiredDescription
variant_idpathstring✓

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/images/builders/{variant_id}/logs

GET/api/v1/images/builders/{variant_id}/logs

서빙 빌더 변형 게시 로그

현재/마지막 게시 Job 의 로그 반환. VIEW 권한이 필요.

Parameters

NameInTypeRequiredDescription
variant_idpathstring✓
run_idquerystring?지난 게시 실행(Job 이름)을 지목해 보존 로그 조회

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/images/builders/{variant_id}/logs/raw

GET/api/v1/images/builders/{variant_id}/logs/raw

서빙 빌더 변형 게시 로그 전문 내려받기

보존된 게시 로그 전문 스트리밍.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
variant_idpathstring✓
run_idquerystring?지난 게시 실행(Job 이름). 비우면 현재 실행

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/images/{image_id}

GET/api/v1/images/{image_id}

모델 이미지 상세

모델 이미지 하나의 상태 반환.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
image_idpathstring (uuid)✓

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/images/{image_id}/logs

GET/api/v1/images/{image_id}/logs

이미지 빌드 로그

빌드 Job 의 로그 반환.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
image_idpathstring (uuid)✓
run_idquerystring?지난 빌드 실행(Job 이름)을 지목해 보존 로그 조회

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/images/{image_id}/logs/raw

GET/api/v1/images/{image_id}/logs/raw

이미지 빌드 로그 전문 내려받기

보존된 빌드 로그 전문 스트리밍.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
image_idpathstring (uuid)✓
run_idquerystring?지난 빌드 실행(Job 이름). 비우면 현재 실행

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

Written for the platform as of 2026-10-02.

© MLOps Central Platform