GizStack 클라우드 아키텍처 및 REST API 명세서

GizStack은 독립 소버린 하드웨어 상에서 구동되는 엔터프라이즈 멀티 리전 클라우드 컴퓨팅 플랫폼입니다.

1. RESTful API 엔드포인트 목록

모든 엔드포인트는 JSON 페이로드를 반환하며, application/json 헤더를 지원합니다.

• GET /api/stack/overview: 클러스터 전체 헬스, CPU/RAM/스토리지 총계 및 리전 현황
• GET /api/stack/vms: 가상 머신 인스턴스 전체 목록
• POST /api/stack/vms: 신규 가상 머신 프로비저닝 (JSON body: name, region, sku, os)
• POST /api/stack/vms/:id/action: VM 상태 전이 (JSON body: action = 'start' | 'stop' | 'restart')
• GET /api/stack/storage: 오브젝트(Blob), NVMe 디스크, POSIX 파일 공유 목록
• GET /api/stack/networks: 가상 네트워크(VNet), 서브넷, 피어링 상태
• GET /api/stack/databases: 매니지드 PostgreSQL, Valkey, Qdrant 클러스터 현황
• GET /api/stack/ai: 소버린 GPU AI 모델 엔드포인트 및 추론 성능 지표
• GET /api/stack/telemetry: 호스트 커널 실시간 부하, 메모리 및 소켓 텔레메트리
• GET /api/stack/billing: FinOps 비용 분석 및 Azure/AWS 대비 TCO 비교 매트릭스
• GET /api/stack/audit: Sarbanes-Oxley (SOX 404) WORM 규정 준수 감사 로그
• GET /api/stack/stream: Server-Sent Events (SSE) 실시간 메트릭 브로드캐스트

2. 가상 머신 프로비저닝 예시 (cURL)

curl -X POST https://gizstack.com/api/stack/vms \
  -H "Content-Type: application/json" \
  -d '{
    "name": "seoul-k8s-worker-01",
    "region": "kr-seoul-1 (dmc1)",
    "sku": "Standard_D8s_v5",
    "os": "Ubuntu 24.04 LTS (Kernel 6.8 bbr)"
  }'

3. 보안 및 거버넌스 보증

GizStack은 외부 퍼블릭 클라우드 종속성을 제거하여 다음과 같은 엄격한 보안 컴플라이언스를 충족합니다:

• 데이터 주권 (Data Sovereignty): 전 데이터와 가상 머신 메모리는 대한민국 및 캐나다 온프레미스 소버린 하드웨어에 완벽히 격리됩니다.
• WORM 무결성 보존: 모든 API 호출과 상태 전이는 SHA-256 해시로 봉인되어 조작이 불가능합니다.
• 초저지연 BBR 네트워킹: 커널 레벨 BBR TCP 혼잡 제어로 글로벌 패킷 손실 환경에서도 최대 대역폭을 유지합니다.