Expenses and Costs:Export and subscribe to bills

Procedure

1. If you are using OSS subscription for the first time, complete authorization by clicking Go to Authorize.

   On the Cloud Resource Access Authorization page, click Agree to Authorization.

   

   

2. Select the Export File type to subscribe to:

   • Monthly Bill PDF: Official financial document aggregated by calendar month, used for settlement and reimbursement.

   • Billing Item Bill Details: Most granular consumption data, including resource instances, billing items, usage, and payable amounts. This data forms the basis for cost analysis.

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

   • Cost Details: Aggregated cost composition for each cost center based on split bill details.

   • Standard Bill FOCUS: Standardized bill data model with consistent fields for easy integration across clouds and systems.

   • Billing Item Detail Bill: Detailed consumption records for each billing item, including usage, unit price, and payable amount.

   • Billing Item Bill Daily Summary: Daily aggregation of consumption for each billing item, showing total daily costs.

   • Billing Item Bill Billing Cycle Summary: Monthly aggregation of consumption for each billing item, showing total costs for the billing cycle.

   • Instance Detail Bill: Detailed consumption records for each resource instance, including instance ID, billing item, usage, unit price, and total price.

   • Instance Bill Daily Summary: Daily aggregation of consumption for each resource instance, showing total daily costs.

   • Instance Bill Billing Cycle Summary: Monthly aggregation of consumption for each resource instance, showing total costs for the billing cycle.

   • Split Bill Daily Summary: Daily aggregation of split bills, with costs allocated by cost center, tag, and other dimensions.

   Note

   • If you have been invited to test the upgraded bill version, upgrade from legacy detail data to the new version as soon as possible.

   • You can create only one bill subscription per Export File type. Already subscribed types are automatically grayed out and cannot be selected again.

3. Set the Start Billing Month.

4. Specify an existing OSS bucket name and set the destination storage path (the system automatically creates the path if it does not exist).

5. Click Create to complete the task.

   

6. View subscription records on the Bill Subscription page.

   

Push schedule

File naming convention

Monthly bill PDF files use the .pdf format. All other file types are .csv files. If the data volume is large, the system automatically splits a single export into multiple files.

Request parameters

Subscription example

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

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

Verify subscription success

Use the aliyun CLI to query OSS subscription records via the QueryBillToOSSSubscription API operation.

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