获取汇总账单

最近更新时间:2021-03-15 20:52:45

查看PDF

DescribeBillSummary(获取汇总账单)

本文档描述如何获取汇总账单信息,支持分产品类型汇总。注意:只支持查询相同月份的数据。

请求参数

名称 类型 必须 长度限制(字符) 参数格式 描述
Action String 确定值 操作接口名,系统规定参数,取值:DescribeBillSummary
Version String 确定值 API版本,固定为2019-07-19
BillStartTime String yyyy-MM-dd HH:mm:ss 必选参数,账单开始时间,(查询结果包含该时间)
BillEndTime String yyyy-MM-dd HH:mm:ss 必选参数,账单结束时间,(查询结果不包含该时间,必须和BillStartTime是同一个月)
ProductCode String 可选参数,产品线对应的Code。eg. VM_GROUP,不传获取所有产品类型的账单,取值可以参考产品线映射关系

返回数据(调用成功)

名称 类型 描述
RequestId String 当前请求的RequestId
TotalCost String 消费总金额
ProductSummarySet ProductSummary 数组 账单汇总数据

错误码(调用不成功)

错误代码(Code) 错误消息(Message) HTTP 状态码 中文描述(语义)
InvalidParameter There is one or more invalid parameter(%s). 400 参数%s错误,具体参数名在%s说明
MissingParameter A required parameter for the specified action is not supplied. 400 忘记必选参数%s,具体参数名在%s说明

示例(调用成功)

请求示例

http://krtpay.api.ksyun.com/?Action=DescribeBillSummary
&Version=2019-07-19
&BillStartTime=2019-07-12 20:00:00
&BillEndTime=2019-07-16 00:00:00
&ProductCode=VM_GROUP
&公共请求参数

返回示例

  • XML格式
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DescribeBillSummaryResponse>
    	<RequestId>5e831fd0-521f-4afe-bb92-1328ce38311a</RequestId>
    	<TotalCost>34.20</TotalCost>
    	<ProductSummarySet>
        	<Item>
            	<Code>VM_GROUP</Code>
            	<Name>云主机</Name>
            	<Cost>34.20</Cost>
        	</Item>
    	</ProductSummarySet>
</DescribeBillSummaryResponse>
  • JSON格式
{
    	"RequestId": "741e499d-7a46-4af5-aacd-f56e419e4fcf",
    	"TotalCost": "34.20",
    	"ProductSummarySet": [
        	{
            	"Name": "云主机",
            	"Code": "VM_GROUP",
            	"Cost": "34.20"
        	}
    	]
}

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈