Export and subscribe to bills

Procedure

1. If you are using an OSS subscription for the first time, you must authorize the service by clicking Authorize.

   On the Cloud resource access authorization page, click Agree to authorization.

2. Select the Export File type to subscribe to:

   • Monthly bill (PDF): An official financial document summarized by calendar month. It contains the official financial seal of Alibaba Cloud and can be used for settlement and reimbursement.

   • Billing item detail: The most granular consumption data — resource instances, billing items, usage, and payable amounts.

   • Split Bill: Bills split by cost centers and allocation rules, used for internal cost accounting.

   • Cost Details: The cost composition of each cost center, aggregated from the split bill detail.

   • Standard Bill FOCUS: A standardized bill data model with well-structured fields, facilitating integration with multi-cloud and multi-system environments.

   • Billing Item Details (By Billing Period): Provides detailed consumption records for each billing item, including usage, unit price, and payable amount.

   • Billing Item Details (By Day): Aggregates the consumption of each billing item on a daily basis and displays the total daily cost.

   • Billing Item Details (By Billing Cycle) : Aggregates the consumption of each billing item over a billing cycle (typically one month) and displays the total cost for the cycle.

   • Instance Details (By Billing Period): Provides detailed consumption records for each resource instance, including instance ID, billing item, usage, unit price, and total price.

   • Instance Details (By Day): Aggregates the consumption of each resource instance on a daily basis and displays the total daily cost.

   • Instance Details (By Billing Cycle): Aggregates the consumption of each resource instance over a billing cycle (typically one month) and displays the total cost for the cycle.

   • Split Bill (By Day): Aggregates split bills on a daily basis and splits costs by dimensions such as cost centers and tags.

   Note

   • If invited to use the upgraded billing feature, upgrade to the new detailed data version promptly.

   • Each Export File type supports only one bill subscription, and a type that has been used is automatically grayed out and cannot be selected again.

3. Set the Start Billing Month.

4. Specify an existing OSS bucket and destination path. The system creates the path if it does not exist.

5. Click Create to complete the task creation.

   

6. On the Bill Subscription page, view the subscription records.

   The subscription list shows columns including Subscribed file, File Name/Table Name, Subscription method, Subscription start cycle, OSS bucket, OSS directory, Subscription time, and Actions. Click View or Cancel in the Actions column to manage subscriptions.

Delivery schedule

File naming convention

PDF monthly bills use .pdf format; all others use .csv. Large bills are automatically split into multiple files.

Request parameters

Subscription example

Use the Alibaba Cloud CLI to call the SubscribeBillToOSS operation. What is Alibaba Cloud CLI?.

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

Verify the subscription

Use the Alibaba Cloud CLI to query billing subscription records for an OSS bucket by calling the QueryBillToOSSSubscription operation.

# Send a subscription query request.
aliyun bssopenapi QueryBillToOSSSubscription --region 'your-region'
# Sample successful 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