GET /api/v1/kubernetes/overview

GET/api/v1/kubernetes/overview

클러스터 개요(KPI)

클러스터 KPI(활성 노드/Pod 수, Ready 비율)와 노드풀 요약을 반환합니다.

응답

상태설명
200Successful Response (object)

GET /api/v1/kubernetes/nodes

GET/api/v1/kubernetes/nodes

노드 목록

클러스터의 노드 인벤토리를 반환합니다(클러스터 전역, 전역 관리자 전용).

응답

상태설명
200Successful Response (object)

GET /api/v1/kubernetes/nodes/{name}

GET/api/v1/kubernetes/nodes/{name}

노드 상세

단일 노드의 상세를 반환합니다(전역 관리자 전용).

파라미터

이름위치형식필수설명
namepathstring

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/kubernetes/gpu

GET/api/v1/kubernetes/gpu

GPU 슬롯 현황

GPU 슬롯의 실시간 점유 현황을 반환합니다(전역 관리자 전용).

응답

상태설명
200Successful Response (object)

GET /api/v1/kubernetes/gpu/wiring

GET/api/v1/kubernetes/gpu/wiring

GPU 배선 현황

GPU 슬롯 배선(공유 풀·테넌트별 모드)과 실시간 점유를 반환합니다.

응답

상태설명
200Successful Response (object)

POST /api/v1/kubernetes/gpu/pools

POST/api/v1/kubernetes/gpu/pools

공유 GPU 풀 등록

이름으로 공유 GPU 풀을 등록합니다(전역 관리자 전용, audit).

요청 본문: application/json, GpuPoolCreateBody

필드형식필수설명
namestringName
slotsintegerSlots
descriptionstringDescription

응답

상태설명
201Successful Response (object)
422Validation Error (HTTPValidationError)

PATCH /api/v1/kubernetes/gpu/pools/{name}

PATCH/api/v1/kubernetes/gpu/pools/{name}

공유 GPU 풀 수정

공유 GPU 풀의 슬롯 수/설명을 수정합니다(전역 관리자 전용, audit).

파라미터

이름위치형식필수설명
namepathstring

요청 본문: application/json, GpuPoolUpdateBody

필드형식필수설명
slotsinteger?Slots
descriptionstring?Description

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/kubernetes/gpu/pools/{name}

DELETE/api/v1/kubernetes/gpu/pools/{name}

공유 GPU 풀 삭제

공유 GPU 풀을 삭제합니다(전역 관리자 전용, audit).

파라미터

이름위치형식필수설명
namepathstring

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

PUT /api/v1/kubernetes/gpu/tenants/{tenant_id}

PUT/api/v1/kubernetes/gpu/tenants/{tenant_id}

테넌트 GPU 배선 설정

테넌트의 GPU 배선 모드를 설정합니다(전역 관리자 전용, audit).

파라미터

이름위치형식필수설명
tenant_idpathstring (uuid)

요청 본문: application/json, TenantGpuBody

필드형식필수설명
modeunwired | shared | dedicatedMode
poolstring?Pool
reservedintegerReserved

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/kubernetes/namespaces

GET/api/v1/kubernetes/namespaces

네임스페이스 목록

클러스터의 네임스페이스 목록을 반환합니다(전역 관리자 전용).

응답

상태설명
200Successful Response (object)

GET /api/v1/kubernetes/workloads

GET/api/v1/kubernetes/workloads

워크로드 목록

네임스페이스의 워크로드를 종류별로 반환합니다(전역 관리자 전용).

파라미터

이름위치형식필수설명
namespacequerystring대상 네임스페이스
kindquerystring워크로드 종류
pagequeryinteger
page_sizequeryinteger?

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/kubernetes/storage/classes

GET/api/v1/kubernetes/storage/classes

StorageClass 목록

클러스터의 StorageClass 목록을 반환합니다(전역 관리자 전용).

응답

상태설명
200Successful Response (object)

GET /api/v1/kubernetes/storage/pvs

GET/api/v1/kubernetes/storage/pvs

PersistentVolume 목록

클러스터의 PersistentVolume 목록을 반환합니다(전역 관리자 전용).

파라미터

이름위치형식필수설명
pagequeryinteger
page_sizequeryinteger?

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/kubernetes/storage/pvcs

GET/api/v1/kubernetes/storage/pvcs

PersistentVolumeClaim 목록

네임스페이스의 PVC 목록을 반환합니다(전역 관리자 전용).

파라미터

이름위치형식필수설명
namespacequerystring대상 네임스페이스
pagequeryinteger
page_sizequeryinteger?

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/kubernetes/workloads/{kind}/{namespace}/{name}/restart

POST/api/v1/kubernetes/workloads/{kind}/{namespace}/{name}/restart

워크로드 rollout restart

워크로드를 rollout restart 합니다(전역 관리자 전용, audit).

파라미터

이름위치형식필수설명
kindpathstring
namespacepathstring
namepathstring

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/kubernetes/workloads/{kind}/{namespace}/{name}/scale

POST/api/v1/kubernetes/workloads/{kind}/{namespace}/{name}/scale

워크로드 scale

워크로드 레플리카 수를 조정합니다(전역 관리자 전용, audit).

파라미터

이름위치형식필수설명
kindpathstring
namespacepathstring
namepathstring

요청 본문: application/json, ScaleBody

필드형식필수설명
replicasintegerReplicas

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/kubernetes/pods/{namespace}/{name}/delete

POST/api/v1/kubernetes/pods/{namespace}/{name}/delete

Pod 삭제

단일 Pod 를 삭제합니다(전역 관리자 전용, audit).

파라미터

이름위치형식필수설명
namespacepathstring
namepathstring

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/kubernetes/nodes/{name}/cordon

POST/api/v1/kubernetes/nodes/{name}/cordon

노드 cordon

노드를 스케줄 불가(cordon)로 표시합니다(global admin 전용, audit).

파라미터

이름위치형식필수설명
namepathstring

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/kubernetes/nodes/{name}/uncordon

POST/api/v1/kubernetes/nodes/{name}/uncordon

노드 uncordon

노드를 다시 스케줄 가능(uncordon)으로 표시합니다(global admin 전용, audit).

파라미터

이름위치형식필수설명
namepathstring

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/kubernetes/nodes/{name}/drain

POST/api/v1/kubernetes/nodes/{name}/drain

노드 drain

노드를 cordon 하고 비-DaemonSet Pod 를 축출합니다(global admin 전용, audit).

파라미터

이름위치형식필수설명
namepathstring

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

2026-09-21 기준 플랫폼에 맞춰 작성했습니다.

© Geo-MLOps