DescribeInstanceSummaryBills

Last updated:2022-06-22 19:53:08

DescribeInstanceSummaryBills

You can call this operation to query the bill summary by instance ID. Note: You can query only the bills of the same month.

Request parameters

Parameter Required Type Description
Action Yes String The operation that you want to perform. Set the value to DescribeInstanceSummaryBills.
Version Yes String The version number of the API operation. Set the value to 2020-01-01.
BillMonth Yes String The billing month, which is in the format of YYYY-MM.
ProductCode No String The code of the product. Example: KEC. This parameter is optional. If you do not specify this parameter, the bills of all products are returned by default. For more information about product codes, see DescribeProductCode.
Page No Integer The number of the page to return. Default value: 1.
Size Yes Integer The number of entries to return on each page. Default value: 20. Valid values: 1 to 1000.

Response parameters

Parameter Type Description
CustomerId Long The ID of the customer.
Email String The email address for logging in to the Kingsoft Cloud console.
SummaryOverview InstanceSummaryBills array The bill summary by instance ID.
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.
RequestId String The ID of the request.

Successful call examples

Sample requests

https://bill-union.api.ksyun.com?Action=DescribeInstanceSummaryBills&Version=2020-01-01&BillMonth=2020-06&Page=1&Size=1&Common request parameters

Sample success responses

  • XML format
<InstanceSummaryResponse>
    <RequestId>0442ae95-223e-47e7-b8fa-3ecb940082f8</RequestId>
    <Email>[email protected]</Email>
    <PageNum>1</PageNum>
    <PageSize>1</PageSize>
    <TotalCount>43</TotalCount>
    <CustomerId>123456</CustomerId>
    <SummaryOverview>
        <SummaryOverview>
            <BillsNo>000000000552791</BillsNo>
            <CustomerBillMonth>2020-06</CustomerBillMonth>
            <BillMonth>2020-06</BillMonth>
            <ProductName>KEC</ProductName>
            <ProductSubTyeName>General Purpose N3</ProductSubTyeName>
            <InstanceId>32ee9517-6ef5-4f3c-b702-219e712a3608</InstanceId>
            <InstanceName>KscPlatformQa</InstanceName>
            <Currency>CNY</Currency>
            <DetailBillStartTime>2020-06-01 00:00:00</DetailBillStartTime>
            <DetailBillEndTime>2020-06-30 23:59:59</DetailBillEndTime>
            <ServiceBillStartTime>2019-02-26 10:50:45</ServiceBillStartTime>
            <PayMode>Postpaid</PayMode>
            <BillTypeName>Pay-By-Daily-Config</BillTypeName>
            <RegionName>CN East 1 (Shanghai)</RegionName>
            <ZoneName>Availability zone B of CN East 1 (Shanghai)</ZoneName>
            <ProjectName>kvmProject</ProjectName>
            <Duration>2592000</Duration>
            <Remark></Remark>
            <Cost>856.000000</Cost>
            <RealCost>642.000000</RealCost>
            <ConfigSet>
                <ConfigSet>
                    <Key>Number of CPU Cores</Key>
                    <code>CPU</code>
                    <Value>8.0000</Value>
                </ConfigSet>
                <ConfigSet>
                    <Key>Size of EBS SSD 3.0, in GB</Key>
                    <code>ebs_ssd3.0_systemDisks</code>
                    <Value>200.0000</Value>
                </ConfigSet>
                <ConfigSet>
                    <Key>Memory size, in GB</Key>
                    <code>MEMORY</code>
                    <Value>16.0000</Value>
                </ConfigSet>
                <ConfigSet>
                    <Key>Package</Key>
                    <code>pkg</code>
                    <Value>N3.8B</Value>
                </ConfigSet>
            </ConfigSet>
            <ProviderSet>
                <ProviderSet>
                    <Key>Operating system</Key>
                    <code>opstype</code>
                    <Value>linux</Value>
                </ProviderSet>
            </ProviderSet>
            <ConsumeResources/>
            <ExtraSet>
                <ExtraSet>
                    <Key>kvm_fixed_ip</Key>
                    <Value>10.0.32.13</Value>
                </ExtraSet>
                <ExtraSet>
                    <Key>kvm_floating_ip</Key>
                    <Value>10.100.59.104</Value>
                </ExtraSet>
            </ExtraSet>
            <TagSet>
                <TagSet>
                    <Key>QA automated instance</Key>
                    <Value>Do not modify</Value>
                </TagSet>
            </TagSet>
        </SummaryOverview>
    </SummaryOverview>
</InstanceSummaryResponse>
  • JSON format
{
    "RequestId": "c5344294-9703-408d-9766-f8fa18faf6e2",
    "Email": "[email protected]",
    "PageNum": 1,
    "PageSize": 1,
    "TotalCount": 43,
    "CustomerId": 123456,
    "SummaryOverview": [
        {
            "BillsNo": "000000000552791",
            "CustomerBillMonth": "2020-06",
            "BillMonth": "2020-06",
            "ProductName": "KEC",
            <ProductSubTyeName>General Purpose N3</ProductSubTyeName>
            "InstanceId": "32ee9517-6ef5-4f3c-b702-219e712a3608",
            "InstanceName": "KscPlatformQa",
            "Currency": "CNY",
            "DetailBillStartTime": "2020-06-01 00:00:00",
            "DetailBillEndTime": "2020-06-30 23:59:59",
            "ServiceBillStartTime": "2019-02-26 10:50:45",
            "PayMode": "Postpaid",
            "BillTypeName": "Pay-By-Daily-Config",
            "RegionName": "CN East 1 (Shanghai)",
            "ZoneName": "Availability zone B of CN East 1 (Shanghai)",
            "ProjectName": "kvmProject",
            "Duration": "2592000",
            "Remark": "",
            "Cost": "856.000000",
            "RealCost": "642.000000",
            "ConfigSet": [
                {
                    "Key": "Number of CPU cores",
                    "Code": "CPU",
                    "Value": "8.0000"
                },
                {
                    "Key": "Size of EBS SSD 3.0, in GB",
                    "Code": "ebs_ssd3.0_systemDisks",
                    "Value": "200.0000"
                },
                {
                    "Key": "Memory size, in GB",
                    "Code": "MEMORY",
                    "Value": "16.0000"
                },
                {
                    "Key": "Package",
                    "Code": "pkg",
                    "Value": "N3.8B"
                }
            ],
            "ProviderSet": [
                {
                    "Key": "Operating system",
                    "Code": "opstype",
                    "Value": "linux"
                }
            ],
            "ConsumeResources": [],
            "ExtraSet": [
                {
                    "Key": "kvm_fixed_ip",
                    "Value": "10.0.32.13"
                },
                {
                    "Key": "kvm_floating_ip",
                    "Value": "10.100.59.104"
                }
            ],
            "TagSet": [
                {
                    "Key": "QA automated instance",
                    "Value": "Do not modify"
                }
            ]
        }
    ]
}

Did you find the above information helpful?

Unhelpful
Mostly Unhelpful
A little helpful
Helpful
Very helpful

What might be the problems?

Insufficient
Outdated
Unclear or awkward
Redundant or clumsy
Lack of context for the complex system or functionality

More suggestions

0/200

Please give us your feedback.

Submitted

Thank you for your feedback.

问题反馈