giip

비용 분석 API 레퍼런스

GIIP 플랫폼에서 집계된 클라우드 및 인프라 비용 데이터와 AI 최적화 제안을 조회하기 위한 API 상세 명세입니다.

📋 개요

비용 분석 API는 여러 클라우드(Azure, AWS 등)와 온프레미스 자원의 비용 데이터를 통합하여 제공합니다. 재무 시스템과의 연동이나 자동 리포트 생성을 위해 활용할 수 있습니다.

🔍 주요 엔드포인트

1. 일일/월일 비용 요약 조회

특정 기간 동안 발생한 전체 비용의 합계를 가져옵니다.

  • URL: GET /cost/summary
  • 주요 파라미터:
    • date_from, date_to: 조회 기간 설정
    • prj_isn (Integer): 특정 프로젝트의 비용만 조회
  • 응답 데이터: 총 금액, 통화(Currency), 전일 대비 변동률 등

2. 자산별 비용 비중 조회

어떤 서버나 데이터베이스에서 가장 많은 비용이 발생하는지 분석합니다.

  • URL: GET /cost/breakdown
  • 응답 데이터: 자산 타입별(VM, DB, Network 등) 비용 리스트

3. AI 비용 최적화 제안 조회

AI가 분석한 자원 조정(Rightsizing)을 통한 비용 절감 예상치를 조회합니다.

  • URL: GET /cost/recommendations
  • 응답 데이터: 대상 자산, 현재 사양, 추천 사양, 예상 절감액

🛠️ 활용 예시 (cURL)

# 이번 달 월간 비용 현황 조회
curl -X GET "https://api.giip.io/v3/cost/summary?period=monthly" \
     -H "x-giip-ak: YOUR_AK"

🛡️ Sk3(고성능 로깅) 활용

비용 데이터 수집의 데이터 무결성 검증과 상세한 감사 로그가 필요한 경우 giipApiSk3 엔드포인트를 권장합니다.

  • 엔드포인트: https://giipfaw.azurewebsites.net/api/giipApiSk3
  • 특합 장점: 자동 에러 로깅, 호출자 메타데이터(IP 등) 추적, jsondata 치환 기능을 통한 복잡한 조회 조건 최적화.
  • 활용 팁: 대규모 인프라 비용 분석 시 text 명령과 jsondata를 조합하여 쿼리 무결성을 보장하며 호출할 수 있습니다.

문제 해결

증상원인해결
401 인증 오류가 발생하거나 빈 응답이 반환됨x-giip-ak 헤더가 없거나 잘못된 키가 입력됨요청 헤더의 x-giip-ak 값에 유효한 AK가 설정되었는지 확인합니다
응답의 RstVal이 200이 아닌 코드를 반환함잘못된 파라미터 또는 조회 조건API 결과 코드 가이드를 참조하여 원인 코드를 확인하고 파라미터를 교정합니다
Sk3의 text 명령 호출이 실패함text 명령 시그니처가 잘못됨text 명령과 jsondata의 조합 형식이 올바른지 확인합니다
jsondata 전달 시 JSON 파싱 오류가 발생함jsondata 내 따옴표가 올바르게 이스케이프되지 않음jsondata 값의 따옴표를 정확히 이스케이프하여 다시 전송합니다

버전: 1.1 최종 업데이트: 2026-04-10 소스 파일: giipv3/public/help/api-cost.ko.md

관련 문서:

← PreviousIssue & Task APIsNext →Monitoring Data API