> ## 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/). For known conformance gaps and workarounds, see [FOCUS conformance](/signup-billing/usage/focus-conformance). 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:

* **One-time exports** that you can create in the [web console](https://console.nebius.com/) or by using [Nebius AI Cloud CLI](/cli).
* **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 exports

### Prerequisites

<Tabs group="interfaces">
  <Tab title="Web console">
    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.
  </Tab>

  <Tab title="Nebius AI Cloud CLI">
    1. [Install and configure](/cli/install) the Nebius AI Cloud CLI.
    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.
  </Tab>
</Tabs>

### How to create an export

<Tabs group="interfaces">
  <Tab title="Web console">
    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. On the **One-time exports** tab, click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/plus.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=7c9efc69d65fc58db0eb73702fd81aa1" width="16" height="16" data-path="_assets/plus.svg" /> **Create export**.
    3. Select the start and end months for your export and click **Create export**.

    When the export is ready, the download will start automatically.

    <Note>
      Export files remain available on the **One-time exports** tab for seven days after their creation.
    </Note>
  </Tab>

  <Tab title="Nebius AI Cloud CLI">
    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>
  </Tab>
</Tabs>

### How to get export details

<Tabs group="interfaces">
  <Tab title="Web console">
    To find a previously created export:

    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. Find the required export on the **One-time exports** tab.
  </Tab>

  <Tab title="Nebius AI Cloud CLI">
    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***
    ```
  </Tab>
</Tabs>

## 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. Switch to the **Periodic export** tab and click **Create export**.

   If you already have a periodic report configured, you need to [delete](#how-to-delete-an-export) it before you can create a new one.

3. In the window that opens, 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`).

4. Click **Create export**.

### How to view the export state

After you create the export, the **Periodic 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 successful 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 **Periodic export** tab, open the **Destination bucket** link.
    2. Next to the export file that you want to download, 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" /> → **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 **Periodic 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. Switch to the **Periodic export** tab.
3. Next to the export, 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.

## How to interpret the export results

The CSV with usage data follows the [FOCUS Column Library](https://focus.finops.org/focus-columns/) and adds Nebius AI Cloud-specific metadata columns. These columns include your [resource hierarchy](/iam/overview#resource-hierarchy) (for example, projects), the trial ID associated with a charge, and the contract price ID associated with a charge. For more information about the exported fields, see [FOCUS fields](/signup-billing/usage/focus-fields).

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.