Queries the bills in a billing cycle.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
BillingCycle | string | Yes | The billing cycle, in the YYYY-MM format. | 2018-07 |
Type | string | No | The type of the bill. Valid values:
| SubscriptionOrder |
ProductCode | string | No | The code of the service. | rds |
ProductType | string | No | The type of the service. | rds |
SubscriptionType | string | No | The billing method. Valid values:
This parameter must be used together with the ProductCode parameter. | Subscription |
IsHideZeroCharge | boolean | No | Specifies whether to filter out a bill whose pretax gross amount is 0. By default, a bill whose pretax gross amount is 0 is not filtered out. Valid values:
| true |
IsDisplayLocalCurrency | boolean | No | Specifies whether to display local currency information in bills. The parameter will be discontinued. | false |
PageNum | integer | No | The number of the page to return. Default value: 1. | 1 |
PageSize | integer | No | The number of entries to return on each page. Default value: 20. Maximum value: 300. | 20 |
BillOwnerId | long | No | The ID of the member. | 123 |
Response parameters
Examples
Sample success responses
JSON
format
{
"Code": "Success",
"Message": "Successful!",
"RequestId": "AE3F4057-DFC9-4B81-8858-F620651010C9",
"Success": true,
"Data": {
"PageNum": 1,
"BillingCycle": "2020-02",
"AccountID": "185xxxxx489",
"PageSize": 1,
"TotalCount": 20,
"AccountName": "test@test.aliyunid.com",
"Items": {
"Item": [
{
"Status": "PayFinish",
"RoundDownDiscount": "0",
"Item": "SubscriptionOrder",
"Currency": "CNY",
"UsageStartTime": "2020-03-11 07:00:00",
"SubscriptionType": "PayAsYouGo",
"DeductedByCashCoupons": 0,
"UsageEndTime": "2020-03-11 08:00:00",
"DeductedByCoupons": 0,
"SubOrderId": "325345254353",
"OutstandingAmount": 0,
"AfterTaxAmount": 0,
"PaymentTime": "2020-03-11 08:00:00",
"PretaxAmountLocal": 0,
"Tax": 0,
"PipCode": "rds",
"PaymentTransactionID": "2O3AADJFEAF2PDKSFAMFCB11918",
"PretaxAmount": 100,
"CommodityCode": "rds",
"ProductName": "ApsaraDB RDS\n",
"RecordID": "2020xxxx5912",
"AdjustAmount": 0,
"ProductDetail": "ApsaraDB RDS (subscription)\n",
"PaymentCurrency": "USD",
"OwnerID": "3532535235",
"DeductedByPrepaidCard": 0,
"ProductType": "rds",
"InvoiceDiscount": 0,
"PaymentAmount": 0,
"PretaxGrossAmount": 0,
"CashAmount": 0,
"ProductCode": "rds"
}
]
}
}
}
Error codes
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2024-03-28 | API Description Update | View Change Details |