Queries pay-as-you-go 2.0 bills.
Operation description
For pay-as-you-go users, the bill details are accurate to the specific resource instance level. For subscription users, only overall queries are supported.
Try it now
Test
RAM authorization
Request syntax
GET HTTP/1.1
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| Lang |
string |
No |
The language. This is an enumeration value. Default value: zh. Valid values: en. |
zh |
| PageSize |
integer |
No |
The maximum number of entries per page in a paged query. Default value: 10. |
10 |
| CurrentPage |
integer |
No |
The page number of the current page in a paged query. |
1 |
| StartTime |
string |
Yes |
The start time of the query, expressed as a UNIX timestamp in seconds. |
1656664560 |
| EndTime |
string |
Yes |
The end time of the query, expressed as a UNIX timestamp in seconds. |
1646063922 |
| Interval |
integer |
No |
The time interval for querying data. This is an enumeration value. Valid values:
Valid values:
|
60 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| TotalCount |
integer |
The total number of entries. |
132 |
| RequestId |
string |
The ID of the request. |
133173B9-8010-5DF5-8B93-******** |
| AggregateInternetTraffic |
number |
The aggregated Internet traffic, in GB. |
10 |
| AggregateNatTraffic |
number |
The aggregated NAT traffic, in GB. |
10 |
| AggregateVpcTraffic |
number |
The aggregated VPC traffic, in GB. |
10 |
| AggregateSdlTraffic |
number |
The aggregated sensitive data detection traffic, in GB. |
10 |
| AggregateTotalTraffic |
number |
The aggregated total traffic, in GB. |
40 |
| BillList |
array<object> |
The bill list. |
|
|
object |
|||
| InternetTraffic |
number |
The Internet traffic, in GB. |
10 |
| NatInstanceCnt |
integer |
The number of NAT instances. |
2 |
| EndTime |
integer |
The end time, expressed as a UNIX timestamp in seconds. The value is on the hour or on the day. |
1733710015 |
| SdlTraffic |
number |
The sensitive data detection traffic, in GB. |
1 |
| InternetInstanceCnt |
integer |
The number of Internet instances. |
3 |
| StartTime |
integer |
The start time, expressed as a UNIX timestamp in seconds. The value is on the hour or on the day. |
1710206070000 |
| LogStorage |
integer |
The log service usage duration, in TB × hours. |
24 |
| NatTraffic |
number |
The NAT traffic, in GB. |
2 |
| VpcInstanceCnt |
integer |
The number of VPC instances. |
2 |
| ThreatIntelligence |
integer |
The threat intelligence usage duration, in hours. |
1 |
| IsDerated |
integer |
Indicates whether a deduction is applied. A value of 0 indicates that no deduction is applied. Any value greater than 0 indicates that a deduction is applied. If a deduction is applied, the bill is not generated. Note
This field is meaningful only when you query data at the hourly level. |
0 |
| Sdl |
integer |
The sensitive data leak detection usage duration, in hours. |
0 |
| VpcTraffic |
number |
The VPC traffic, in GB. |
4 |
Examples
Success response
JSON format
{
"TotalCount": 132,
"RequestId": "133173B9-8010-5DF5-8B93-********",
"AggregateInternetTraffic": 10,
"AggregateNatTraffic": 10,
"AggregateVpcTraffic": 10,
"AggregateSdlTraffic": 10,
"AggregateTotalTraffic": 40,
"BillList": [
{
"InternetTraffic": 10,
"NatInstanceCnt": 2,
"EndTime": 1733710015,
"SdlTraffic": 1,
"InternetInstanceCnt": 3,
"StartTime": 1710206070000,
"LogStorage": 24,
"NatTraffic": 2,
"VpcInstanceCnt": 2,
"ThreatIntelligence": 1,
"IsDerated": 0,
"Sdl": 0,
"VpcTraffic": 4
}
]
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | ErrorAliUid | The aliuid is invalid. | The aliuid is invalid. |
| 400 | ErrorNotPostpayUser | not Postpay User. | Non-pay-as-you-go Users. |
| 400 | ErrorTimeError | The time is invalid. | The time is invalid. |
| 400 | ErrorPageNo | Either page number or page size is invalid. | Either page number or page size is invalid. |
| 400 | ErrorDBSelectError | A database select error occurred. | The error message returned because an internal error has occurred in querying the database. |
| 400 | ErrorMarshalJSON | internal error. | Internal error. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.