kubernetes
kubernetes API, 20 endpoints (generated)
GET /api/v1/kubernetes/overview
GET/api/v1/kubernetes/overview
클러스터 개요(KPI)
클러스터 KPI(활성 노드/Pod 수, Ready 비율)와 노드풀 요약을 반환합니다.
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
GET /api/v1/kubernetes/nodes
GET/api/v1/kubernetes/nodes
노드 목록
클러스터의 노드 인벤토리를 반환합니다(클러스터 전역, 전역 관리자 전용).
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
GET /api/v1/kubernetes/nodes/{name}
GET/api/v1/kubernetes/nodes/{name}
노드 상세
단일 노드의 상세를 반환합니다(전역 관리자 전용).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/kubernetes/gpu
GET/api/v1/kubernetes/gpu
GPU 슬롯 현황
GPU 슬롯의 실시간 점유 현황을 반환합니다(전역 관리자 전용).
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
GET /api/v1/kubernetes/gpu/wiring
GET/api/v1/kubernetes/gpu/wiring
GPU 배선 현황
GPU 슬롯 배선(공유 풀·테넌트별 모드)과 실시간 점유를 반환합니다.
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
POST /api/v1/kubernetes/gpu/pools
POST/api/v1/kubernetes/gpu/pools
공유 GPU 풀 등록
이름으로 공유 GPU 풀을 등록합니다(전역 관리자 전용, audit).
Request body: application/json, GpuPoolCreateBody
| Field | Type | Required | Description |
|---|---|---|---|
name | string | ✓ | Name |
slots | integer | ✓ | Slots |
description | string | Description |
Responses
| Status | Description |
|---|---|
| 201 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
PATCH /api/v1/kubernetes/gpu/pools/{name}
PATCH/api/v1/kubernetes/gpu/pools/{name}
공유 GPU 풀 수정
공유 GPU 풀의 슬롯 수/설명을 수정합니다(전역 관리자 전용, audit).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ |
Request body: application/json, GpuPoolUpdateBody
| Field | Type | Required | Description |
|---|---|---|---|
slots | integer? | Slots | |
description | string? | Description |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
DELETE /api/v1/kubernetes/gpu/pools/{name}
DELETE/api/v1/kubernetes/gpu/pools/{name}
공유 GPU 풀 삭제
공유 GPU 풀을 삭제합니다(전역 관리자 전용, audit).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
PUT /api/v1/kubernetes/gpu/tenants/{tenant_id}
PUT/api/v1/kubernetes/gpu/tenants/{tenant_id}
테넌트 GPU 배선 설정
테넌트의 GPU 배선 모드를 설정합니다(전역 관리자 전용, audit).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenant_id | path | string (uuid) | ✓ |
Request body: application/json, TenantGpuBody
| Field | Type | Required | Description |
|---|---|---|---|
mode | unwired | shared | dedicated | ✓ | Mode |
pool | string? | Pool | |
reserved | integer | Reserved |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/kubernetes/namespaces
GET/api/v1/kubernetes/namespaces
네임스페이스 목록
클러스터의 네임스페이스 목록을 반환합니다(전역 관리자 전용).
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
GET /api/v1/kubernetes/workloads
GET/api/v1/kubernetes/workloads
워크로드 목록
네임스페이스의 워크로드를 종류별로 반환합니다(전역 관리자 전용).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
namespace | query | string | ✓ | 대상 네임스페이스 |
kind | query | string | 워크로드 종류 | |
page | query | integer | ||
page_size | query | integer? |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/kubernetes/storage/classes
GET/api/v1/kubernetes/storage/classes
StorageClass 목록
클러스터의 StorageClass 목록을 반환합니다(전역 관리자 전용).
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
GET /api/v1/kubernetes/storage/pvs
GET/api/v1/kubernetes/storage/pvs
PersistentVolume 목록
클러스터의 PersistentVolume 목록을 반환합니다(전역 관리자 전용).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
page | query | integer | ||
page_size | query | integer? |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/kubernetes/storage/pvcs
GET/api/v1/kubernetes/storage/pvcs
PersistentVolumeClaim 목록
네임스페이스의 PVC 목록을 반환합니다(전역 관리자 전용).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
namespace | query | string | ✓ | 대상 네임스페이스 |
page | query | integer | ||
page_size | query | integer? |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation 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).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
kind | path | string | ✓ | |
namespace | path | string | ✓ | |
name | path | string | ✓ |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/kubernetes/workloads/{kind}/{namespace}/{name}/scale
POST/api/v1/kubernetes/workloads/{kind}/{namespace}/{name}/scale
워크로드 scale
워크로드 레플리카 수를 조정합니다(전역 관리자 전용, audit).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
kind | path | string | ✓ | |
namespace | path | string | ✓ | |
name | path | string | ✓ |
Request body: application/json, ScaleBody
| Field | Type | Required | Description |
|---|---|---|---|
replicas | integer | ✓ | Replicas |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/kubernetes/pods/{namespace}/{name}/delete
POST/api/v1/kubernetes/pods/{namespace}/{name}/delete
Pod 삭제
단일 Pod 를 삭제합니다(전역 관리자 전용, audit).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
namespace | path | string | ✓ | |
name | path | string | ✓ |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/kubernetes/nodes/{name}/cordon
POST/api/v1/kubernetes/nodes/{name}/cordon
노드 cordon
노드를 스케줄 불가(cordon)로 표시합니다(global admin 전용, audit).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/kubernetes/nodes/{name}/uncordon
POST/api/v1/kubernetes/nodes/{name}/uncordon
노드 uncordon
노드를 다시 스케줄 가능(uncordon)으로 표시합니다(global admin 전용, audit).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/kubernetes/nodes/{name}/drain
POST/api/v1/kubernetes/nodes/{name}/drain
노드 drain
노드를 cordon 하고 비-DaemonSet Pod 를 축출합니다(global admin 전용, audit).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | ✓ |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |