Skip to main content
An export helps you integrate Nebius usage data with external tools for cost analysis and reporting. The export delivers data in CSV format that complies with the FinOps Open Cost and Usage Specification (FOCUS 1.2). This specification is compatible with most industry-standard cost management systems. The export contains detailed hourly information about everything that affects your invoice: commitment consumption, adjustments and taxes.

​
Export types

There are two types of exports available:
  • Periodic export that you configure in the web console. It runs automatically on a regular schedule and delivers data to your Object Storage bucket once per hour. You are charged for storing and working with data in Object Storage; for more details, see Pricing in Object Storage.
    You can have one active periodic export at a time for a given contract.
  • One-time export that you can perform by using the Nebius AI Cloud CLI.

​
Periodic export

​
Prerequisites

Make sure you are in a group that has the admin role within your tenant or project; for example, the default admins group. You can check this in the Administration → IAM section of the web console.

​
How to create an export

To set up a periodic export of your usage data, do the following:
  1. In the web console, go to https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/billing.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=32dc60dbf43597f6132b7f4b303a6901 Billing → Export.
  2. Configure your export:
    1. Choose a month when the export should start.
    2. Choose a project and an Object Storage bucket to store usage data. You can choose an existing bucket or create a new one. New buckets use the Standard storage class by default.
    3. (Optional) Specify a bucket prefix: folder path within the bucket (for example, /billing/export).
  3. Click Create export.

​
How to view the export state

After you create the export, the Export tab displays its configuration and state. You can view the following information:
  • Name and ID: The export name and unique identifier.
  • Created: The date and time when the export was created.
  • Last run: The date and time of the most recent export run.
  • Status: The current export status. For a Failed status, hover over the status to find out the reason for failure.
  • Destination bucket: The link to the bucket where exported data is delivered.

​
How to access the export files

To access files in an Object Storage bucket that stores the usage data, you must have at least the storage.viewer role at the level of the bucket, its parent project or tenant. By default, all users in the viewers, editors and admins default groups in the tenant can access files in the bucket. You can also set up a custom group to restrict access to the bucket. To download the export files:
  1. On the Export tab, open the Destination bucket link.
  2. To the right of each required export file, click https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad → https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/arrow-down.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=d4fdb7255a9f3cc2d87c11b84676ff84 Download.

​
How to delete an export

You can delete the export to stop periodic data exports:
  1. In the web console, go to https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/billing.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=32dc60dbf43597f6132b7f4b303a6901 Billing → Export.
  2. In the export line, click https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad → Delete export.
Deleting the export does not remove existing export files from Object Storage. If you no longer need the exported files, delete the corresponding bucket or objects separately.

​
One-time export

​
Prerequisites

  1. Install and configure the Nebius AI Cloud CLI.
  2. Make sure you are in a group that has at least the viewer role within your tenant; for example, the default viewers group. You can check this in the Administration → IAM section of the web console.

​
How to create an export

To create a one-time export, run the following command: 
nebius billing v1alpha1 one-time-export create \
  --parent-id contract-e00*** \
  --start-period <yyyy-mm> \
  --end-period <yyyy-mm> \
  --format export_format_focus_1_2_csv
In the command, specify the following parameters:
  • --parent-id: Contract ID. To get it:
    1. Go to the web console.
    2. In the sidebar, go to https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/billing.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=32dc60dbf43597f6132b7f4b303a6901 Billing → Payments.
    3. Switch to the Billing details tab and copy the contract ID in the Payer section.
  • --start-period: Export start date in the yyyy-mm format.
  • --end-period: Export end date in the yyyy-mm format.
  • --format: Export format. Only export_format_focus_1_2_csv is supported.
The link to download the archive with the export is specified in the .status.download_url parameter of the output: 
metadata:
  ...
spec:
  ...
status:
  ...
  download_url: 'https://storage.eu-north1.nebius.cloud/billing-report-exports-external/onetimeexport/...'
  ...
All export download links expire after 15 minutes, but the export files themselves remain available for seven days.

​
How to get export details

To get details of a previously created export, run the following command: 
nebius billing v1alpha1 one-time-export get \
  --id billingonetimeexport-e00***
If you don’t know the ID of the export, you can list all one-time exports created for a specific contract: 
nebius billing v1alpha1 one-time-export list \
  --parent-id contract-e00***

​
How to interpret the export results

The CSV with usage data follows the FOCUS Column Library and adds one Nebius AI Cloud column: x_ContainerId, which shows your resource hierarchy (for example, projects). Exports always use the latest container name. If a container is deleted, we keep its last known name. If a container is renamed, the new name appears even in exports for earlier months. If you use commitment discounts, CommitmentDiscountStatus = Unused shows the portion of the commitment that was prepaid but not consumed. You can also view the effective price for each VM by hour. If your bill for a month includes an adjustment, it appears as a separate line item in the CSV.