获取汇总账单

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"
        	}
    	]
}