All Documents
Current Document

Content is empty

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

Documentation

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. You can query only the bills of the same month.
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>st7@kit.com</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": "st7@kit.com",
    "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"
                }
            ]
        }
    ]
    }
On this page
Pure ModeNormal Mode

Pure Mode

Click to preview the document content in full screen
Feedback