DescribePostpayBill

更新时间:
复制 MD 格式

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

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

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:

  • 3600: queries data at the hourly level.

  • 86400: queries data at the daily level.

Valid values:

  • 3600 :

    hour.

  • 86400 :

    day.

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.