models
models API, 12 endpoints (generated)
모델 레지스트리: 스테이지 매트릭스, 버전 이력, 일대일 비교 및 프로덕션 승격 요청.
GET /api/v1/models
GET/api/v1/models
스테이지 매트릭스를 포함한 등록 모델 목록
테넌트의 등록된 모델을 스테이지별 매트릭스와 함께 나열합니다.
Permission: VIEW
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
production | query | boolean? | true = Production 버전이 있는 모델만, false = 없는 모델만 | |
page | query | integer | ||
page_size | query | integer? | ||
q | query | string? | 이름 부분 일치 검색 | |
sort | query | string? | 정렬 키 | |
order | query | string | asc | desc |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/models/summary
GET/api/v1/models/summary
production/staging/archived 개수
테넌트의 모델 개수를 스테이지별로 집계합니다.
Permission: VIEW
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
GET /api/v1/models/{name}/versions
GET/api/v1/models/{name}/versions
버전 이력
등록된 모델의 전체 버전 이력을 반환합니다.
Permission: VIEW
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ | |
page | query | integer | ||
page_size | query | integer? |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/models/{name}/versions/{version}
GET/api/v1/models/{name}/versions/{version}
모델 버전 단건 조회
모델 버전 하나를 반환합니다.
Permission: VIEW
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/models/{name}/{version}/download
GET/api/v1/models/{name}/{version}/download
모델 버전 아티팩트 다운로드
모델 버전의 아티팩트를 파일로 내려받습니다.
Permission: VIEW
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/models/{name}/compare
GET/api/v1/models/{name}/compare
두 모델 버전 비교
모델의 두 버전을 나란히 일대일 비교합니다.
Permission: VIEW
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ | |
from | query | string | ✓ | |
to | query | string | ✓ |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/models/{name}/{version}/comments
GET/api/v1/models/{name}/{version}/comments
일대일 비교 코멘트 목록
특정 모델 버전에 대한 일대일 비교(H2H) 코멘트를 나열합니다.
Permission: VIEW
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/models/{name}/{version}/comments
POST/api/v1/models/{name}/{version}/comments
코멘트 추가
모델 버전에 일대일 비교(H2H) 코멘트를 추가합니다.
Permission: DEVELOP
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
Request body: application/json, CommentCreate
| Field | Type | Required | Description |
|---|---|---|---|
body | string | ✓ | Body |
Responses
| Status | Description |
|---|---|
| 201 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/models/{name}/{version}/promote
POST/api/v1/models/{name}/{version}/promote
프로덕션 승격 요청
모델 버전을 Production으로 승격하도록 요청합니다(화면 8 진입점).
Permission: PRODUCTION_PROMOTE
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
Request body: application/json, PromoteRequest
| Field | Type | Required | Description |
|---|---|---|---|
to_version | string | ✓ | To Version |
reason | string | ✓ | Reason |
rollback_conditions | string? | Rollback Conditions | |
scope | string? | Scope |
Responses
| Status | Description |
|---|---|
| 201 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/models/{name}/{version}/stage
POST/api/v1/models/{name}/{version}/stage
모델 버전 스테이지 강등
모델 버전을 Archived/Staging/None 스테이지로 옮깁니다.
Permission: STAGING_PROMOTE
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
Request body: application/json, StageChange
| Field | Type | Required | Description |
|---|---|---|---|
stage | string | ✓ | Stage |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
DELETE /api/v1/models/{name}/{version}
DELETE/api/v1/models/{name}/{version}
모델 버전 등록 해제
등록된 모델에서 버전 하나를 삭제합니다.
Permission: MODEL_REGISTER
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ | |
version | path | string | ✓ |
Responses
| Status | Description |
|---|---|
| 204 | Successful Response |
| 422 | Validation Error (HTTPValidationError) |
DELETE /api/v1/models/{name}
DELETE/api/v1/models/{name}
등록 모델 삭제
등록된 모델을 전체 버전과 함께 레지스트리에서 삭제합니다.
Permission: MODEL_REGISTER
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ |
Responses
| Status | Description |
|---|---|
| 204 | Successful Response |
| 422 | Validation Error (HTTPValidationError) |