All Documents
Current Document

Content is empty

If you don't find the content you expect, please try another search term

Documentation

DescribeBills

Last updated:2021-07-16 15:31:59

DescribeBills

You can call this operation to query Pay-As-You-Go bills. Note: You can query only the bills of the same month.

Request parameters

Parameter Type Required Length (number of characters) Format Description
Action String Yes Fixed value The operation that you want to perform. Set the value to DescribeBills.
Version String Yes Fixed value The version number of the API operation. Set the value to 2019-07-19.
BillStartTime String Yes yyyy-MM-dd HH:mm:ss The start time of the bill. This parameter is required. The query result contains this time.
BillEndTime String Yes yyyy-MM-dd HH:mm:ss The end time of the bill. This parameter is required. The query result does not contain this time. The bill end time must be in the same month as the bill start time.
ProductCode String No The code of the product. Example: KEC. This parameter is optional. If you do not specify this parameter, bills of all products are returned. For more information about product codes, see DescribeProductCode.
Page Integer No The number of the page to return. Default value: 1.
Size Integer No The number of entries to return on each page. Default value: 20. Valid values: 1 to 1000.


Response parameters

Parameter Type Description
RequestId String The ID of the request.
PageNum Integer The page number of the returned page.
PageSize Integer The number of entries returned per page.
TotalCount Integer The total number of entries.
BillSet DescribeBills array The bill summary.


Error codes

Error code Error message HTTP status code Description
InvalidParameter There is one or more invalid parameter(%s). 400 The error message returned because the %s parameter is invalid. For more information about the parameter, see %s.
MissingParameter A required parameter for the specified action is not supplied. 400 The error message returned because the %s parameter is not specified. For more information about the parameter, see %s.


Successful call examples

Sample requests

http://krtpay.api.ksyun.com/?Action=DescribeBills
&Version=2019-07-19
&BillStartTime=2019-07-12 20:00:00
&BillEndTime=2019-07-16 00:00:00
&ProductCode=VM_GROUP
&Common request parameters

Sample success responses

  • XML format
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <DescribeBillsResponse>
        <RequestId>976e913d-1db9-42d1-8251-cdad4f7c1005</RequestId>
        <PageNum>1</PageNum>
        <PageSize>1</PageSize>
        <TotalCount>88</TotalCount>
        <BillSet>
            <Item>
                <AccountPeriod>2019071523</AccountPeriod>
                <BillsNo>ZD20000747601002782019071523300000000000</BillsNo>
                <CustomerId>2000074760</CustomerId>
                <BillsType>3</BillsType>
                <BillsTypeName>Billing by hour</BillsTypeName>
                <ProductCode>VM_GROUP</ProductCode>
                <ProductName>KEC</ProductName>
                <Project>278</Project>
                <ProjectName>hanziguoproject</ProjectName>
                <BillStartTime>2019-07-15 23:00:00</BillStartTime>
                <BillEndTime>2019-07-16 00:00:00</BillEndTime>
                <Cost>0.45</Cost>
                <RealCost>0.45</RealCost>
            </Item>
        </BillSet>
    </DescribeBillsResponse>
  • JSON format
    {
        "RequestId": "60a9f62e-51b3-4ec5-8e9d-12cb78343014",
        "PageNum": 1,
        "PageSize": 1,
        "TotalCount": 88,
        "BillSet": [
            {
                "BillsNo": "ZD20000747601002782019071523300000000000",
                "BillsType": 3,
                "BillsTypeName": "Billing by hour",
                "Project": 278,
                "ProjectName": "hanziguoproject",
                "ProductName": "KEC",
                "ProductCode": "VM_GROUP",
                "Cost": "0.45",
                "RealCost": "0.45",
                "BillStartTime": "2019-07-15 23:00:00",
                "BillEndTime": "2019-07-16 00:00:00", 
                "CustomerId": 2000074760,
                "AccountPeriod": "2019071523"
            }
        ]
    }
On this page
Pure ModeNormal Mode

Pure Mode

Click to preview the document content in full screen
Feedback