费用分析 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-CN.md

相关文档:

• API 结果代码指南 (RstVal)