> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nebius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Exporting usage data as CSV in Nebius AI Cloud

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)](https://focus.finops.org/focus-specification/v1-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](https://console.nebius.com/). It runs automatically on a regular schedule and delivers data to your [Object Storage](/object-storage/index) bucket once per hour. You are charged for storing and working with data in Object Storage; for more details, see [Pricing in Object Storage](/object-storage/resources/pricing).

  <Note>
    You can have one active periodic export at a time for a given contract.
  </Note>

* **One-time export** that you can perform by using the [Nebius AI Cloud CLI](/cli).

## Periodic export

### Prerequisites

Make sure you are in a [group](/iam/authorization/groups/index) that has the `admin` role within your tenant or project; for example, the default `admins` group. You can check this in the [Administration → IAM](https://console.nebius.com/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](https://console.nebius.com/billing), go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/billing.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=32dc60dbf43597f6132b7f4b303a6901" width="16" height="16" data-path="_assets/sidebar/billing.svg" /> **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](/object-storage/storage-classes) 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](/iam/authorization/roles#object-storage) at the level of the bucket, its parent project or tenant. By default, all users in the `viewers`, `editors` and `admins` [default groups](/iam/authorization/groups/index) in the tenant can access files in the bucket. You can also [set up a custom group](/iam/authorization/groups/manage) to restrict access to the bucket.

To download the export files:

<Tabs>
  <Tab title="Web console">
    1. On the **Export** tab, open the **Destination bucket** link.
    2. To the right of each required export file, click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/arrow-down.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=d4fdb7255a9f3cc2d87c11b84676ff84" width="16" height="16" data-path="_assets/arrow-down.svg" /> **Download**.
  </Tab>

  <Tab title="AWS CLI">
    1. [Install the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) and [configure it](/object-storage/interfaces/aws-cli) to work with your buckets in Nebius AI Cloud.
    2. On the **Export** tab, open the **Destination bucket** link.
    3. Copy the bucket name and prefix from the bucket page.
    4. Use them in the commands for [downloading the bucket objects](/object-storage/objects/upload-download#how-to-download).
  </Tab>
</Tabs>

### How to delete an export

You can delete the export to stop periodic data exports:

1. In the [web console](https://console.nebius.com/), go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/billing.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=32dc60dbf43597f6132b7f4b303a6901" width="16" height="16" data-path="_assets/sidebar/billing.svg" /> **Billing** → **Export**.

2. In the export line, click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → **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](/object-storage/buckets/manage#how-to-delete-buckets) or [objects](/object-storage/objects/manage#how-to-delete-objects) separately.

## One-time export

### Prerequisites

1. [Install and configure the Nebius AI Cloud CLI](/cli/quickstart).
2. Make sure you are in a [group](/iam/authorization/groups/index) that has at least the `viewer` role within your tenant; for example, the default `viewers` group. You can check this in the [Administration → IAM](https://console.nebius.com/iam) section of the web console.

### How to create an export

To create a one-time export, run the following command:

```bash theme={null}
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](https://console.nebius.com/).
  2. In the sidebar, go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/billing.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=32dc60dbf43597f6132b7f4b303a6901" width="16" height="16" data-path="_assets/sidebar/billing.svg" /> **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:

```yaml theme={null}
metadata:
  ...
spec:
  ...
status:
  ...
  download_url: 'https://storage.eu-north1.nebius.cloud/billing-report-exports-external/onetimeexport/...'
  ...
```

<Note>
  All export download links expire after 15 minutes, but the export files themselves remain available for seven days.
</Note>

### How to get export details

To get details of a previously created export, run the following command:

```bash theme={null}
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:

```bash theme={null}
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](https://focus.finops.org/focus-columns/) and adds one Nebius AI Cloud column: **x\_ContainerId**, which shows your [resource hierarchy](/iam/overview#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](/signup-billing/billing-models/committed-usage), `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.