按实例或者计费项统计费用信息
接口说明
按实例或者计费项统计费用信息
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /api/v1/bills/sum HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
按照实例或者计费项统计费用信息的入参,eg. {"startDate":1775714495313,"endDate":1776232895313,"statsType":"FEE_ITEM","topN":8} |
|
| projectNames |
array |
否 |
实例名称列表,如果 statsType 是 FEE_ITEM 的时候,则 projectNames 列表不用传 |
|
|
string |
否 |
实例名称 |
projectName |
|
| startDate |
integer |
否 |
费用统计周期开始时间 |
1715393576201 |
| endDate |
integer |
否 |
费用统计周期的结束时间 |
1776232895313 |
| statsType |
string |
否 |
统计类型,枚举值:PROJECT(实例)或者 FEE_ITEM(费用项) |
PROJECT |
| topN |
integer |
否 |
费用排序之后前多少项 |
5 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
PopResult |
||
| requestId |
string |
请求 ID。 |
BB66A390-4EF7-557E-9489-7F98D6F44002 |
| httpCode |
integer |
http 状态码 |
200 |
| data |
object |
返回结果 |
|
| totalCost |
string |
下面费用项的费用的总和 |
123.56 |
| currency |
string |
币种,固定值 |
CNY |
| itemBills |
array<object> |
费用项列表 |
|
|
object |
费用项对象 |
||
| itemName |
string |
当费用项类型为 PROJECT 时,表示实例名称;当费用项类型为 FEE_ITEM 时,itemName 可能是 DRStorage,ComputationSql,Storage 等等。 |
projectName |
| cost |
string |
费用 |
123.56 |
| currency |
string |
币种 |
CNY |
| percentage |
number |
费用占当前总费用的百分比,不带百分号 |
56.12 |
示例
正常返回示例
JSON格式
{
"requestId": "BB66A390-4EF7-557E-9489-7F98D6F44002",
"httpCode": 200,
"data": {
"totalCost": "123.56",
"currency": "CNY",
"itemBills": [
{
"itemName": "projectName",
"cost": "123.56",
"currency": "CNY",
"percentage": 56.12
}
]
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。