财务汇总

查询你的财务和计费的汇总信息。

提示：返回的数据截止至上一个小时或更早时候，它与控制台中显示的数据相比可能有1个小时或更长的延迟。

获取权限

必须由帐号所有者在控制台为凭据开通权限后才可以访问本接口。

1. 前往控制台-项目管理
2. 点击需要启用控制台API的凭据
3. 向下滑动至“控制台权限”
4. 勾选“允许访问财务汇总数据”
5. 点击“保存”按钮

请求路径

/finance/v1/summary

参数

无需参数。

请求示例

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your_api_host/finance/v1/summary'

请将your_token替换为你的JWT身份认证，将your_api_host替换为你的API Host

返回数据

{
  "metadata": {
    "tag": "2a9873efd0a6c75665dc4f6116b19bdf"
  },
  "asOf": "2024-04-03T17:13Z",
  "currency": "CNY",
  "balance": -17.54,
  "accruedCharges": {
    "previousDay": 28.92,
    "thisMonth": 113.12,
    "sinceLastBill": 113.12
  },
  "pendingBills": [
    {
      "number": "20681CYX",
      "date": "2024-04-01T10:00Z",
      "type": "PayAsYouGo",
      "status": "unpaid",
      "amount": 535.1,
      "amountDue": 17.54,
      "dueDate": "2024-04-10T23:59Z"
    },
    {
      "number": "605D0FYX",
      "date": "2024-04-02T13:34Z",
      "type": "SavingsPlans",
      "status": "unpaid",
      "amount": 2000,
      "amountDue": 2000,
      "dueDate": "2024-04-30T12:59Z"
    }
  ],
  "availableSavingsPlans": [
    {
      "billNumber": "605D0FYX",
      "status": "pending",
      "term": "1",
      "commitments": 2000,
      "utilized": 0,
      "effectiveTime": "2024-04-30T13:00Z"
    }
  ],
  "availableResourcePlans": []
}

• asOf 当前数据的截止日期。
• currency 货币代码，包括：CNY和USD。
• balance 可用额度。
• accruedCharges.previousDay 前一天应计费用总额。
• accruedCharges.thisMonth 本月应计费用总额。
• accruedCharges.sinceLastBill 从上次出账以来的应计费用总额。
• pendingBills.number 待支付账单号。
• pendingBills.type 待支付账单的类型。
• pendingBills.amount 账单的总金额。
• pendingBills.amountDue 账单剩余应付金额。
• pendingBills.dueDate 应付日期。
• availableSavingsPlans.billNumber 生效中或待生效的节省计划账单号。
• availableSavingsPlans.status 节省计划状态，包括 pending和active。
• availableSavingsPlans.term 承诺期限。
• availableSavingsPlans.commitments 承诺金额。
• availableSavingsPlans.utilized 已用承诺金额。
• availableSavingsPlans.effectiveTime 生效时间。
• availableResourcePlans.billNumber 生效中或待生效的资源包账单号。
• availableResourcePlans.status 资源包状态，包括 pending和active。
• availableResourcePlans.requests 总请求量。
• availableResourcePlans.utilized 已用请求量。
• availableResourcePlans.effectiveTime 生效时间。