获取消耗月账单

最近更新时间:2019-11-11 20:12:49

获取消耗月账单(getMonthConsume)

描述

查询用户当前月最新消耗汇总信息,支持分产品类型汇总。

注意 只支持查询最近两个月的数据

返回API概览

请求参数

名称 类型 必须 长度限制(字符) 参数格式 描述
Action String 确定值 操作接口名,系统规定参数,取值:getMonthConsume
Version String 确定值 API版本,固定为2018-06-01
BillMonth String YYYY-MM 必选参数,账单月份

返回元素(调用成功)

名称 类型 描述
RequestId String 当前请求的RequestId
BeginDate String 此次汇总的消耗开始计量日期
EndDate String 此次汇总的消耗结束计量日期
MonthBillSet MonthConsume 数组 消耗月账单汇总数据

错误码(调用不成功)

错误代码(Code) 错误消息(Message) HTTP 状态码 中文描述(语义)
InvalidParameter There is one or more invalid parameter(%s)." 400 参数%s错误,具体参数名在%s说明
Forbidden Request user %s forbidden request this api" 400 用户禁止请求API,用户uid在%s指名
Server unavailable Server error 500 后端服务异常

示例(调用成功)

获取2019-08的账单汇总数据

请求示例

https://bill.api.ksyun.com/?Action=getMonthConsume
&Version=2018-06-01
&BillMonth=2019-08
&公共请求参数

返回示例

  • XML格式
<GetMonthConsumeResponse>
    <BeginDate>2019-08-01</BeginDate>
    <EndDate>2019-08-28</EndDate>
    <RequestId>9a12cb1f-85bc-4a69-a4f5-5f669f22d8eb</RequestId>
    <MonthBillSet>
        <Item>
            <BillProductSet>
                <Item>
                    <Code>KSS</Code>
                    <Cost>8207703.66</Cost>
                    <Name>KSS存储</Name>
                </Item>
            </BillProductSet>
            <BillId>KSYZD0073406772201908</BillId>
            <Sum>8207703.66</Sum>
            <BillType>postpay</BillType>
            <BillMonth>2019-08</BillMonth>
        </Item>
    </MonthBillSet>
</GetMonthConsumeResponse>
  • JSON示例
{
    "BeginDate": "2019-08-01",
    "EndDate": "2019-08-28",
    "RequestId": "9a12cb1f-85bc-4a69-a4f5-5f669f22d8eb",
    "MonthBillSet": [
        {
            "BillProductSet": [
                {
                    "Code": "KSS",
                    "Cost": 8207703.66,
                    "Name": "KSS存储"
                }
            ],
            "BillId": "KSYZD0073406772201908",
            "Sum": 8207703.66,
            "BillType": "postpay",
            "BillMonth": "2019-08"
        }
    ]
}

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

注册有礼