비용 분석 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

  를 조합하여 쿼리 무결성을 보장하며 호출할 수 있습니다.

---

버전: 1.1 최종 업데이트: 2026-04-10 소스 파일:

giipv3/public/help/api-cost.ko.md

---

관련 문서:

• API 결과 코드 가이드 (RstVal)