Export Alibaba Cloud FOCUS 1.0 (Preview)
Alibaba Cloud supports exporting cost and usage data based on the FinOps Open Cost and Usage Specification (FOCUS)™. This standardized cloud billing data format helps you perform cost analysis and resource optimization more efficiently.
You are included in the invitational preview if you can see the Bills > Bill Subscription menu in the Expenses and Costs console.
The exported FOCUS data is for analysis only and cannot be used for reconciliation. For final settlement and payment, use the official bill overview or bill details that Alibaba Cloud provides.
The FOCUS data export feature is free of charge. However, it uses the Bill Subscription feature to export data to OSS, and you will be charged storage fees by OSS based on the file type, size, and storage duration.
What is FOCUS?
The FinOps Open Cost and Usage Specification (FOCUS)™ is a technical specification designed to standardize cost and usage data from different cloud providers. It sets clear requirements for systems that generate billing data in the cloud computing industry, ensuring consistent cost and usage datasets. Click here to visit the official FOCUS website for detailed information.
Export Alibaba Cloud FOCUS 1.0 (Preview)
The final data for the current month is exported after 12:00 (UTC+8) on the 4th day of the next month.
In the Expenses and Costs console, choose Bills > Bill Subscription, and click Create Bill Subscription.
On the OSS Subscription tab, set Export File to Standard Bill FOCUS.
Set the Start Billing Month. You can select the current month or previous months. The earliest available subscription starts from the first month billed after the upgraded version for the invitational preview was launched.
Set the subscription directory. For OSS Bucket, enter the bucket name. If you want to store the data in a specific directory within the bucket, enter the directory path in the OSS Directory field. After completing the settings, click Create.
On the Bill Subscription page, view the subscription records.
The subscription list displays columns such as Subscribed file, File Name/Table Name, Subscription method, Subscription start cycle, OSS bucket, OSS directory, Subscription time, and Actions. In the Actions column, you can click View or Cancel to manage the subscription.
Delivery schedule
Bill type | Daily delivery (UTC+8) | Final monthly delivery (UTC+8) |
billing item detail | Full detailed data for the current month to date | By 18:00 on the 3rd of the following month |
split bill detail | Full detailed data for the current month to date | By 18:00 on the 4th of the following month |
cost detail | Full detailed data for the current month to date | By 18:00 on the 4th of the following month |
Standard Bill FOCUS | Full detailed data for the current month to date | By 18:00 on the 4th of the following month |
PDF monthly bill | Not supported | By 18:00 on the 3rd of the following month |
File naming convention
The PDF monthly bill is in .pdf format. All other file types are .csv files. If a bill is too large, the system automatically splits it into multiple files.
Subscription type | Naming convention | Directory structure | Example |
|
|
|
|
|
|
|
|
The actual files exported to OSS may be compressed in
.zipformat.If the page does not distinguish between the new and old versions of detailed data when you select Export File, the file naming convention is based on the old version.
FOCUS 1.0 fields
Alibaba Cloud FOCUS 1.0 (Preview) is an invitational preview version and is under active development. Some fields may differ from the FOCUS 1.0 requirements. For details, see Alibaba Cloud FOCUS 1.0 (Preview) field conformance gaps.
Field | Description | Data type | Nullable |
AvailabilityZone | A provider-assigned identifier for a physically isolated area within a region that provides high availability and fault tolerance. This corresponds to an Alibaba Cloud availability zone. | String | Yes |
BilledCost | The charge that serves as the basis for billing. It includes all applicable discounts and credits but excludes the amortization of upfront fees (one-time or recurring). | Decimal | No |
BillingAccountId | The provider-assigned identifier for the billing account. | String | No |
BillingAccountName | The display name of the billing account. | String | Yes |
BillingCurrency | The currency in which the charge was billed. | String | No |
BillingPeriodEnd | The end date and time of the billing period. | Date/Time | No |
BillingPeriodStart | The start date and time of the billing period. | Date/Time | No |
ChargeCategory | The highest-level classification based on the billing nature of the charge. | String | No |
ChargeClass | Indicates whether the row is a correction to a previously invoiced billing period. | String | Yes |
ChargeDescription | A self-contained summary of the charge's purpose and price. | String | Yes |
ChargeFrequency | Identifies the frequency at which a charge is incurred. | String | No |
ChargePeriodEnd | The end date and time of the charge period. | Date/Time | No |
ChargePeriodStart | The start date and time of the charge period. | Date/Time | No |
CommitmentDiscountCategory | Identifies whether a commitment discount is based on usage quantity or cost (that is, "spend"). | String | Yes |
CommitmentDiscountId | The provider-assigned identifier for a commitment discount. | String | Yes |
CommitmentDiscountName | The display name of a commitment discount. | String | Yes |
CommitmentDiscountStatus | Indicates whether a charge is related to the consumption of a commitment discount or the unused portion of a committed amount. | String | Yes |
CommitmentDiscountType | The provider-assigned identifier for the type of commitment discount applied to the current row. | String | Yes |
ConsumedQuantity | The usage of a resource or service measured in consumed units. | Decimal | Yes |
ConsumedUnit | The provider-specified unit of measurement for resource or service usage. | String | Yes |
ContractedCost | The cost calculated by multiplying the contracted unit price by the corresponding pricing quantity. | Decimal | No |
ContractedUnitPrice | The contracted unit price for a single pricing unit. This price includes negotiated discounts but excludes commitment discounts. | Decimal | Yes |
EffectiveCost | The actual cost after all discounts, credits, and amortized upfront fees are applied. | Decimal | No |
InvoiceIssuerName | The name of the entity that invoices consumed resources or services. | String | No |
ListCost | The cost calculated by multiplying the public unit price by the corresponding pricing quantity. | Decimal | No |
ListUnitPrice | The provider-published suggested unit price for a single pricing unit, excluding discounts. | Decimal | Yes |
PricingCategory | Describes the pricing model used for a charge at the time of usage or purchase. | String | Yes |
PricingQuantity | The quantity of a resource or service that is used or purchased, measured in pricing units. | Decimal | Yes |
PricingUnit | The provider-specified unit of measurement for pricing, which is used for usage measurement after rules such as tiered pricing are applied. | String | Yes |
ProviderName | The name of the entity that provides purchasable resources or services. | String | No |
PublisherName | The name of the entity that produces purchased resources or services. | String | No |
RegionId | The provider-assigned identifier of the geographical region where a resource is deployed or a service is provided. | String | Yes |
RegionName | The name of the geographical region where a resource is deployed or a service is provided. | String | Yes |
ResourceId | The provider-assigned identifier for a resource. | String | Yes |
ResourceName | The display name of a resource. | String | Yes |
ResourceType | The type of resource to which a charge applies. | String | Yes |
ServiceCategory | The highest-level classification based on the core function of a service. | String | No |
ServiceName | A service purchased from a provider, such as a cloud virtual machine, a Software as a Service (SaaS) database, or professional services from a system integrator. | String | No |
SkuId | A unique, provider-defined identifier used to organize the common properties of SKU prices. | String | Yes |
SkuPriceId | A unique identifier that defines the unit price used to calculate a charge. | String | Yes |
SubAccountId | The ID for a group of resources or services, typically used to manage access and/or costs. | String | Yes |
SubAccountName | The name of a group of resources or services, typically used to manage access and/or costs. | String | Yes |
Tags | A collection of tags assigned to a tag source, which may include provider- or user-defined tags. | JSON | Yes |
X_CommodityCode | The unique code that Alibaba Cloud uses to identify a specific commodity within a cloud product. | string | No |
X_CommodityName | The name of a specific commodity within a cloud product. | string | No |
X_BillingItemCode | The code of the billable item to which the cloud resource fees belong. | string | No |
X_BillingItemName | The name of the billable item to which the cloud resource fees belong. | string | No |
X_InstanceID | The dimension for cost statistics and summarization in billing. The If a product's | string | No |