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. |
| 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.