Cost

쿼리 비용 추적 및 예산 관리 API입니다. 쿼리별 비용 기록, 비용 요약, 예산 설정 및 상태 조회 기능을 제공합니다.

엔드포인트

POST /api/v1/cost/record

설명: 쿼리 실행 비용을 기록합니다. (HTTP 201)

요청 본문:

필드	타입	필수	설명
query_id	string	Y	쿼리 ID
bytes_scanned	int	Y	스캔된 바이트 수
cpu_time_ms	int	N	CPU 시간 (밀리초)

GET /api/v1/cost/queries

설명: 쿼리 비용 이력을 반환합니다. 기간, 사용자별 필터를 지원합니다.

GET /api/v1/cost/summary

설명: 비용 요약 정보를 반환합니다. 기간별/사용자별 집계를 제공합니다.

GET /api/v1/cost/budget

설명: 현재 예산 상태를 반환합니다.

응답:

{
  "budget_limit": 1000.0,
  "used": 450.0,
  "remaining": 550.0,
  "usage_percent": 45.0
}

POST /api/v1/cost/budget

설명: 예산을 생성 또는 업데이트합니다. (HTTP 201)

인증

JWT Bearer 토큰이 필요합니다.

에러 코드

코드	설명
400	잘못된 비용 기록 또는 예산 설정
500	비용 집계 또는 저장 실패