費用分析 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

• 響應數據: 按資產類型（虛擬機、資料庫、網絡等）排列的費用列表

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

  結合使用，確保在調用過程中查詢的完整性。

疑難排解

x-giip-ak

x-giip-ak

RstVal

text

text

text

jsondata

jsondata

jsondata

jsondata

版本: 1.1 最後更新: 2026-04-11 源碼:

giipv3/public/help/api-cost.zh-TW.md

相關文檔:

• API 結果代碼指南 (RstVal)