获取账单汇总

最近更新时间:2019-08-03 10:46:21

获取账单汇总(DescribeBillSummary)

描述

查询用户账单汇总信息,支持分产品类型汇总。

注意 只支持查询相同月份的数据

返回API概览

请求参数

名称 类型 必须 长度限制(字符) 参数格式 描述
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"
            }
        ]
    }

金山云,开启您的云计算之旅

注册有礼