Contact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.

Exporting extended usage details

Written by
Updated at April 20, 2026

You can get a CSV file with your general or per-resource spending details. You can either download the file once or set up its regular export.

One-time export

  1. Go to Yandex Cloud Billing.

  2. Select the account you want the details for.
  3. In the left-hand panel, select Usage details.
  4. At the top right, click More and select Export usage details.
  5. In the window that opens, select:
    • Export file format: CSV or PDF.
    • Time period you want the details for.
    • Display language for product names: Русский or English.
    • Detailed view type: General or Resource.
  6. Click Download.

Regular export

Getting started

  1. If you do not have any folders yet, create one. In the folder name, specify the project or client to use the folder.

  2. Create a bucket in Yandex Object Storage. Yandex Cloud will save the files with details to this bucket. You can save your details in multiple buckets.

    Alert

    Bucket requirements:

    • Do not make your bucket public; otherwise, anyone will be able to download your expense details using the bucket link.
    • Do not configure an access policy for the bucket.

  3. Optionally, for additional details protection, set up bucket encryption.
    To export details to an encrypted bucket, you need a service account that will be handling the export. To manage this service account, the billing account needs the iam.serviceAccounts.user role.

  4. Verify that your billing account has the roles required for operations involving regular exports.
    To create, stop, or resume regular exports, the user needs one of the following roles:

    • billing.accounts.editor
    • billing.accounts.accountant
    • billing.accounts.varWithoutDiscounts

    To view regular exports, the user needs one of the following roles:

    • billing.accounts.viewer
    • billing.accounts.varWithoutDiscount

For more information, see Service roles in Yandex Cloud Billing.

Setting up a regular export

  1. Go to Yandex Cloud Billing.

  2. Select the account you want the details for.

  3. Go to the regular export setting:

    1. In the left-hand panel, select Usage details.
    2. At the top right, click More and select Periodic export.
    1. In the left-hand panel, select  Export details.
    2. Click Create periodic export.

  4. In the window that opens, specify the following:

    • Name of the bucket to store the CSV file with details.

    • If selecting an encrypted bucket, specify an existing service account or create a new one:

      1. In the Service account field, specify the service account.
      2. When you see a message about missing roles, click Add roles and wait for a message saying they were successfully added.
      1. In the Service account field, click Create service account.
      2. Enter a name for the service account.
      3. Click Save.

    Note

    One service account can handle multiple regular exports. However, roles must be assigned separately for each encrypted bucket and KMS key.

    • Name of the details file folder. Make sure the last character is /.

    • Display language for product names: Русский or English.

    • Detailed view type: General or Resource.

      Tip

      If you select Resource for a regular export of details, the resource_id field will allow you to view the Yandex DataLens, Yandex Tracker, and DataSphere resources (e.g., DataSphere community IDs).

  5. Optionally, to add data for a previous period, enable Export historical data. In the Start from field that appears, select the desired detailed report start date. You can get data starting from the billing account creation date.

  6. Click Create.

If you have not selected a data export for a previous period, the first details will be dated with the date of creating the regular export. A new file with details is created in the bucket daily. The file name contains a prefix and the date covered by the details. The file gets overwritten and updated with new data every hour.

The information in any daily file can be updated within a month.

Tip

Files with details are not deleted from the bucket automatically; however, you can schedule them to be deleted from time to time. For more information, see Object lifecycle (Object Storage refers to files in a bucket as objects).

Stopping a regular export

  1. Go to Yandex Cloud Billing.

  2. Select the account you want to stop a regular export for.
  3. In the left-hand panel, select  Export details.
  4. Click next to the regular export and select Delete.

Resuming a regular export

You can resume a Failed export. Resolve the error and resume the export:

  1. Go to Yandex Cloud Billing.

  2. Select the account you want to resume an export for.
  3. In the left-hand panel, select  Export details.
  4. Click next to the regular export and select Resume.

Viewing regular exports

You can view all your regular exports and their info: bucket, prefix, type of detail, status, ID, last modified date, and creation date.

  1. Go to Yandex Cloud Billing.

  2. Select the account you want to view details for.
  3. In the left-hand panel, select  Export details.
  4. Select the details file.

Expense details file format

An uploaded file with details is a CSV table with comma-separated columns. Each row shows the product consumption level per day for the specified folder.

The table contains the following columns:

  • billing_account_id: Billing account ID.
  • billing_account_name: Billing account name.
  • cloud_id: ID of the cloud covered by the details.
  • cloud_name: Cloud name.
  • folder_id: Folder ID.
  • folder_name: Name of the folder at the time of exporting the details. This field may be empty if you deleted the folder before exporting the details.
  • resource_id: Resource ID, resource name, or subscription ID. Use only for regular export. The value of this field may be empty if the use of the service refers to the entire folder or it does not contain any resources. The services and resource_id column values are mapped as follows:
    • Compute Cloud and Cloud Marketplace: ID of the VM, disk snapshot, disk image, or other resource installed using Cloud Marketplace.
    • Object Storage: Bucket name.
    • Virtual Private Cloud: ID of the resource that processes incoming or outgoing traffic.
    • KMS: Key ID.
    • Network Load Balancer: Load balancer ID.
    • Container Registry: Container ID.
    • Kubernetes and Yandex Data Processing: Cluster ID.
    • Managed Service for PostgreSQL, Managed Service for ClickHouse®, Yandex StoreDoc, Managed Service for MySQL®, Yandex Managed Service for Valkey™, and Managed Service for Apache Kafka®: Host ID in the cluster.
    • Message Queue: Request ID.
    • Cloud Functions: Function ID.
    • Monitoring, Yandex IoT Core, SpeechKit, Translate, and Vision OCR: Empty value.
    • DataLens: DataLens instance ID.
    • Technical support: Subscription ID.
  • service_id: ID of the service the consumed product belongs to.
  • service_name: Name of the service the consumed product belongs to.
  • sku_id: Consumed product ID.
  • sku_name: Product name.
  • date: Consumption charge date. A date is set as an interval from 0:00 to 23:59 (UTC+3).
  • currency: Billing account currency. Possible values: RUB, USD, and KZT.
  • pricing_quantity: Number of product units consumed. The decimal separator is a period.
  • pricing_unit: Product consumption unit.
  • cost: Total cost of consumption. The decimal separator is a period.
  • credit: Total discounts. Not included in the total cost of consumption (credit). Always negative. The decimal separator is a period.
  • monetary_grant_credit: Grant discount, including the platform introduction grant. The decimal separator is a period.
  • volume_incentive_credit: Consumption volume discount. The decimal separator is a period.
  • cud_credit: Discount for the committed resource volume. The cost of the consumption volume above the committed one equals the sum of the cost and credit column values. The decimal separator is a period.
  • misc_credit: Other types of discounts, including discounts for consumption after the platform introduction grant expires but before switching to the paid version. The decimal separator is a period.
  • label.user_labels.<label_name>: Labels added to the resources. For information about how to manage labels, see Managing labels.
  • locale: Language of each exported line. This field's value determines the sku_name column language. The possible values are en and ru.
  • updated_at: Date and time of the last line update in Unix Timestamp format.
  • exported_at: Date and time when the line was added to the details file.
Deprecated parameters
  • created_at: Date and time when the specified consumption charge was made, provided in Unix Timestamp format.
  • label.system_labels.folder_id: Folder ID. The value is now displayed in the folder_id column.
See also

ClickHouse® is a registered trademark of ClickHouse, Inc.

Previous
Viewing usage details in Yandex DataLens
Next
Getting usage details via the API