获取月账单

最近更新时间:2018-08-01 11:42:35

获取月账单(GetMonthBill)

描述

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

注意 只支持查询2018-06以后的数据

返回API概览

请求参数

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

返回元素(调用成功)

名称 类型 描述
RequestId String 当前请求的RequestId
MonthBillSet MonthBill 数组 月账单汇总数据

错误码(调用不成功)

错误代码(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 后端服务异常

示例(调用成功)

获取2018-06的账单汇总数据

请求示例

https://bill.api.ksyun.com/?Action=GetMonthBill
&Version=2018-06-01
&BillStartMonth=2018-06
&BillEndMonth=2018-06
&公共请求参数

返回示例

  • XML格式
<GetMonthBillResponse>
    <RequestId>ht-test</RequestId>
    <MonthBillSet>
        <Item>
            <Sum>284.38</Sum>
            <BillType>postpay</BillType>
            <BillMonth>2018-06</BillMonth>
            <BillId>KSYZD0073400575201806</BillId>
            <BillProductSet>
                <Item>
                    <Cost>55.0</Cost>
                    <Code>KEC</Code>
                    <Name>云服务器(KEC)</Name>
                </Item>
                <Item>
                    <Cost>145.0</Cost>
                    <Code>KRDS</Code>
                    <Name>关系型数据库(KRDS)</Name>
                </Item>
                <Item>
                    <Cost>84.38</Cost>
                    <Code>Redis</Code>
                    <Name>云数据库(Redis)</Name>
                </Item>
                <Item>
                    <Cost>0.0</Cost>
                    <Code>KS3</Code>
                    <Name>对象存储(KS3)</Name>
                </Item>
            </BillProductSet>
            <BillProjectSet>
                <ProjectItem>
                    <Id>0</Id>
                    <Cost>284.38</Cost>
                    <Name>默认项目</Name>
                </ProjectItem>
                <ProjectItem>
                    <Id>1</Id>
                    <Cost>0.0</Cost>
                    <Name></Name>
                </ProjectItem>
                <ProjectItem>
                    <Id>2</Id>
                    <Cost>0.0</Cost>
                    <Name></Name>
                </ProjectItem>
                <ProjectItem>
                    <Id>3</Id>
                    <Cost>0.0</Cost>
                    <Name></Name>
                </ProjectItem>
            </BillProjectSet>
        </Item>
    </MonthBillSet>
</GetMonthBillResponse>
  • JSON示例
{
    "RequestId": "ht-test",
    "MonthBillSet": [
        {
            "Sum": 284.38,
            "BillType": "postpay",
            "BillMonth": "2018-06",
            "BillId": "KSYZD0073400575201806",
            "BillProductSet": [
                {
                    "Cost": 55,
                    "Code": "KEC",
                    "Name": "云服务器(KEC)"
                },
                {
                    "Cost": 145,
                    "Code": "KRDS",
                    "Name": "关系型数据库(KRDS)"
                },
                {
                    "Cost": 84.38,
                    "Code": "Redis",
                    "Name": "云数据库(Redis)"
                },
                {
                    "Cost": 0,
                    "Code": "KS3",
                    "Name": "对象存储(KS3)"
                }
            ],
            "BillProjectSet": [
                {
                    "Id": 0,
                    "Cost": 284.38,
                    "Name": "默认项目"
                },
                {
                    "Id": 1,
                    "Cost": 0,
                    "Name": ""
                },
                {
                    "Id": 2,
                    "Cost": 0,
                    "Name": ""
                },
                {
                    "Id": 3,
                    "Cost": 0,
                    "Name": ""
                }
            ]
        }
    ]
}

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

立即注册