Expenses and Costs:Export and subscribe to bills

Procedure

1. If you are using OSS subscription for the first time, you must grant permissions. Click Go to Authorize.

   On the Cloud Resource Access Authorization page, click Confirm Authorization Policy.

   

   

2. Select the Export File type to subscribe to.

   • Monthly Bill PDF: An official financial document calculated by calendar month that is used for settlement and reimbursement.

   • Billable Item Billing Details: The most granular spending data, which includes resource instances, billable items, usage, and payable amounts. This data is the basis for cost analysis.

   • Split Bill Details: Bills that are split by cost center and allocation rules and used for internal cost accounting.

   • Cost Details: The cost composition of each cost center, which is aggregated based on split bill details.

   • Standard Bill FOCUS: A standardized bill data model with well-organized fields that facilitates integration with multi-cloud and multiple systems.

   • Billable Item Detail Bill: Provides detailed spending records for each billable item, which include usage, unit price, and payable amount.

   • Billable Item Bill Daily Summary: Summarizes the spending for each billable item on a daily basis and shows the total daily cost.

   • Billable Item Bill Billing Cycle Summary: Summarizes the spending for each billable item by billing cycle, which is usually one month, and shows the total cost for the cycle.

   • Instance Detail Bill: Provides detailed spending records for each resource instance, which include the instance ID, billable item, usage, unit price, and total price.

   • Instance Bill Daily Summary: Summarizes the spending for each resource instance on a daily basis and shows the total daily cost.

   • Instance Bill Billing Cycle Summary: Summarizes the spending for each resource instance by billing cycle, which is usually one month, and shows the total cost for the cycle.

   • Split Bill Daily Summary: Summarizes the split bill on a daily basis and splits costs based on dimensions such as cost centers and tags.

   Note

   • If you have been invited to preview the upgraded bills, we recommend that you upgrade from the old detailed data to the new version as soon as possible.

   • You can create only one bill subscription for each Export File type. A type for which a subscription has already been created is grayed out and cannot be selected again.

3. Set the Start Billing Month.

4. Specify the name of an existing OSS bucket and set the destination storage path. If the path does not exist, the system creates it automatically.

5. Click Create to create the task.

   

6. View subscription records on the Bill Subscription page.

   

Push time

File naming convention

• Format: All bill files are compressed in .zip format. Large files are automatically split and named in the format ..._part_001.zip.

• Naming: {Account UID}_{Site ID}_{Bill Type}_{YYYYMM}.zip

  • Site ID: 1 for Alibaba Cloud China Website (www.aliyun.com), 2 for Alibaba Cloud International Website (www.alibabacloud.com)

• Folder: {Specified Folder}/{YYYYMM}/{YYYYMMDDHHMMSS}/

Request parameters

Subscription example

Use the Alibaba Cloud CLI to send a subscription request using the SubscribeBillToOSS API. For more information about the CLI, see What is Alibaba Cloud CLI.

# Send a subscription request
aliyun bssopenapi SubscribeBillToOSS --SubscribeType 'your-billing-type' --SubscribeBucket 'your-bucket-name' --BucketPath 'your-bucket-path'
# Success response
{
    "Code": "Success",
    "Message": "Successful!",
    "RequestId": "55C79633-4F63-3839-8815-XXXXXXXXXX",
    "Success": true
}

Verify a successful subscription

You can use the Alibaba Cloud CLI to query records for bill subscriptions to an OSS bucket by calling the QueryBillToOSSSubscription operation.

# Send a subscription query request
aliyun bssopenapi QueryBillToOSSSubscription --region 'your-region'
# Success response
{
    "Code": "Success",
    "Data": {
        "AccountID": "XXXX",
        "AccountName": "XXXX",
        "Items": {
            "Item": [
                {
                    "BucketOwnerId": XXXX,
                    "BucketPath": "bill-data/",
                    "MultAccountRelSubscribe": "MA",
                    "SubscribeBucket": "XXXX",
                    "SubscribeLanguage": "en",
                    "SubscribeTime": "2026-01-27 16:42:49",
                    "SubscribeType": "BillingItemDetailForBillingPeriod"
                }
            ]
        }
    },
    "Message": "Successful!",
    "RequestId": "B1CCC55E-CD6F-3ABC-AABC-XXXXXXXX",
    "Success": true
}

Common error codes