[Документация Yandex Cloud](../../index.md) > [Yandex Cloud Billing](../index.md) > [Пошаговые инструкции](index.md) > Анализ использования сервисов Yandex Cloud > Детализация расходов > Экспортировать расширенную детализацию

# Экспортировать расширенную детализацию

Вы можете получать CSV-файл с общей или поресурсной детализацией расходов. Файл можно [скачать](#single-time-download) разово или [настроить](#regular-download) получение на постоянной основе.

## Разовый экспорт {#single-time-download}

{% list tabs group=instructions %}

- Интерфейс Yandex Cloud Billing {#billing}

  1. Перейдите в сервис [**Yandex Cloud Billing**](https://kz.console.yandex.cloud/billing).
  1. Выберите аккаунт, для которого хотите получить детализацию.
  1. На панели слева выберите ![image](../../_assets/console-icons/square-chart-column.svg) **Детализация**.
  1. Справа вверху нажмите **Ещё** и выберите **Выгрузить детализацию**.
  1. В открывшемся окне выберите:
     * Формат выгрузки — `CSV` или `PDF`.
     * Промежуток времени, за который хотите получить детализацию.
     * Язык отображения названий продуктов — `Русский` или `English`.
     * Тип детализации — `Общая` или `Поресурсная`.
  1. Нажмите кнопку **Скачать**.

{% endlist %}

## Регулярный экспорт {#regular-download}

### Перед началом работы {#before-you-begin}

1. Если у вас еще нет разделения на [каталоги](../../resource-manager/concepts/resources-hierarchy.md#folder), [создайте каталог](../../resource-manager/operations/folder/create.md). В названии каталога укажите имя проекта или клиента, который будет использовать его.

1. [Создайте бакет](../../storage/operations/buckets/create.md) в сервисе Yandex Object Storage. В этом бакете Yandex Cloud будет сохранять файлы с детализацией. Вы можете сохранять детализацию в нескольких бакетах.
   
    {% note alert %}
    
    Требования к бакету:
     
    * Не делайте бакет публичным, иначе любой сможет скачать вашу детализацию по ссылке на бакет.
    * Не настраивайте [политику доступа](../../storage/concepts/policy.md) для бакета.

    {% endnote %}

1. (Опционально) Для дополнительной защиты детализации настройте [шифрование бакета](../../storage/operations/buckets/encrypt.md).
   Чтобы экспортировать детализацию в бакет с шифрованием, необходим сервисный аккаунт, который будет обслуживать экспорт. Для управления этим сервисным аккаунтом платежному аккаунту должна быть назначена роль `iam.serviceAccounts.user`.

   Для выгрузки данных в зашифрованный бакет дополнительно потребуются следующие роли:
   * `storage.uploader`;
   * `storage.configurer`;
   * `kms.keys.encrypter`.

1. Убедитесь, что вашему платежному аккаунту назначены необходимые роли для операций с регулярным экспортом.
   Создание, прекращение и возобновление регулярных экспортов доступны пользователям с одной из следующих ролей:
     * `billing.accounts.editor`;
     * `billing.accounts.accountant`;
     * `billing.accounts.varWithoutDiscounts`.
   
   Просмотр регулярных экспортов доступен пользователям с одной из следующих ролей:
     * `billing.accounts.viewer`;
     * `billing.accounts.varWithoutDiscount`.
  
  Подробнее в разделе [Сервисные роли в Yandex Cloud Billing](../security/index.md).

### Настроить регулярный экспорт {#set-up-regular-download}

{% list tabs group=instructions %}

- Интерфейс Yandex Cloud Billing {#billing}

  1. Перейдите в сервис [**Yandex Cloud Billing**](https://kz.console.yandex.cloud/billing).
  1. Выберите аккаунт, для которого хотите получить детализацию.
  1. Перейдите к настройке регулярного экспорта:
   
      {% list tabs %}

       - Раздел Детализация
  
         1. На панели слева выберите ![image](../../_assets/console-icons/square-chart-column.svg) **Детализация**.
         1. Справа вверху нажмите **Ещё** и выберите **Регулярный экспорт**.

      - Раздел Экспорт детализации

          1. На панели слева выберите ![image](../../_assets/console-icons/arrow-up-from-square.svg) **Экспорт детализации**.
          1. Нажмите **Создать регулярный экспорт**.

      {% endlist %}

  1. В открывшемся окне укажите:
     * Имя бакета, где будет храниться CSV-файл с детализацией.
     * При выборе бакета с шифрованием укажите существующий сервисный аккаунт или создайте новый:
  
        {% list tabs %}

          - Существующий аккаунт
  
              1. В поле **Сервисный аккаунт** укажите сервисный аккаунт.
              1. При появлении сообщения о недостающих ролях нажмите кнопку **Добавить роли** и дождитесь сообщения об их добавлении.

          - Новый аккаунт

              1. В поле **Сервисный аккаунт** нажмите **Создать сервисный аккаунт**.
              1. Введите имя сервисного аккаунта.
              1. Нажмите **Сохранить**.
          
          {% endlist %}
    
      {% note info %}

       Один сервисный аккаунт может обслуживать несколько регулярных экспортов. При этом на каждый зашифрованный бакет и KMS-ключ необходимо назначать [роли](#before-you-begin) отдельно.

      {% endnote %}

     * Название папки для файла детализации. Последний символ должен быть `/`.
     * Язык отображения названий продуктов – `Русский` или `English`.
     * Тип детализации — `Общая` или `Поресурсная`.

         {% note tip %}

         Выбирая тип `Поресурсная` для регулярного экспорта детализации, вы сможете просматривать в [поле `resource_id`](#format) ресурсы сервисов Yandex DataLens, Яндекс Трекер и DataSphere, например [идентификаторы сообществ DataSphere](../../datasphere/concepts/community.md).

         {% endnote %}

  1. (Опционально) Чтобы добавить данные за предыдущий период, включите опцию **Экспорт данных за предыдущий период**. В появившемся поле **Загрузить отчёты начиная с** выберите дату, с которой вы хотите получить детализацию. Данные доступны с момента создания платежного аккаунта.

  1. Нажмите кнопку **Создать**.

{% endlist %}

Если вы не выбрали экспорт данных за предыдущий период, то датой первой детализации будет день создания регулярной выгрузки. Каждый день в бакете создается новый файл с детализацией. В имени файла указывается префикс и дата, за которую собрана детализация. Файл перезаписывается каждый час, дополняясь новыми данными.

Информация может быть обновлена в любом дневном файле в течение месяца.

{% note tip %}

Файлы с детализацией из бакета автоматически не удаляются, но вы можете настроить периодическое удаление файлов. Подробнее читайте в разделе [Жизненный цикл объектов](../../storage/concepts/lifecycles.md) (в терминах Object Storage файлы в бакете называются _объектами_).

{% endnote %}

### Прекратить регулярный экспорт {#stop-export}

{% list tabs group=instructions %}

- Интерфейс Yandex Cloud Billing {#billing}

  1. Перейдите в сервис [**Yandex Cloud Billing**](https://kz.console.yandex.cloud/billing).
  1. Выберите аккаунт, для которого хотите прекратить регулярный экспорт.
  1. На панели слева выберите ![image](../../_assets/console-icons/arrow-up-from-square.svg) **Экспорт детализации**.
  1. Напротив регулярного экспорта нажмите ![image](../../_assets/console-icons/ellipsis.svg) и выберите **Удалить**.

{% endlist %}

### Возобновить регулярный экспорт {#recover-export}

Экспорт, который завершился с ошибкой (статус `Failed`), можно возобновить. Устраните ошибку и возобновите выгрузку:

{% list tabs group=instructions %}

- Интерфейс Yandex Cloud Billing {#billing}

  1. Перейдите в сервис [**Yandex Cloud Billing**](https://kz.console.yandex.cloud/billing).
  1. Выберите аккаунт, для которого хотите возобновить экспорт.
  1. На панели слева выберите ![image](../../_assets/console-icons/arrow-up-from-square.svg) **Экспорт детализации**.
  1. Напротив регулярного экспорта нажмите ![image](../../_assets/console-icons/ellipsis.svg) и выберите **Возобновить**.

{% endlist %}

### Просмотреть регулярные экспорты {#view-export}

Для просмотра доступны все созданные регулярные экспорты и информация о них: бакет, префикс, тип детализации, статус, идентификатор, дата последнего изменения и дата создания.

{% list tabs group=instructions %}

- Интерфейс Yandex Cloud Billing {#billing}

  1. Перейдите в сервис [**Yandex Cloud Billing**](https://kz.console.yandex.cloud/billing).
  1. Выберите аккаунт, у которого хотите посмотреть детализацию.
  1. На панели слева выберите ![image](../../_assets/console-icons/arrow-up-from-square.svg) **Экспорт детализации**.
  1. Выберите файл с детализацией.

{% endlist %}

### Довыгрузка данных в регулярный экспорт {#additional-export}

Чтобы выгрузить данные за прошлые периоды, которых не было в ранее созданном экспорте:

{% list tabs group=instructions %}

- Интерфейс Yandex Cloud Billing {#billing}

  1. Перейдите в сервис [**Yandex Cloud Billing**](https://kz.console.yandex.cloud/billing).
  1. Выберите аккаунт, для которого хотите довыгрузить данные в регулярный экспорт.
  1. На панели слева выберите ![image](../../_assets/console-icons/arrow-up-from-square.svg) **Экспорт детализации**.
  1. Напротив нужного регулярного экспорта нажмите ![image](../../_assets/console-icons/ellipsis.svg) и выберите ![image](../../_assets/console-icons/circle-plus.svg) **Довыгрузка данных**.
  1. В поле **Период** укажите необходимый диапазон дат и нажмите **Создать**.
  1. Дождитесь сообщения о применении довыгрузки к регулярному экспорту.

  Данные будут выгружены при следующем обновлении регулярного экспорта.

{% endlist %}

## Формат файла с детализацией расходов {#format}

Выгружаемый файл с детализацией — это таблица в CSV-формате (столбцы разделены запятой). Каждая строка отражает потребление продукта за день для указанного каталога.

Таблица содержит следующие столбцы:

* `billing_account_id` — идентификатор [платежного аккаунта](../concepts/billing-account.md).
* `billing_account_name` — имя платежного аккаунта.
* `cloud_id` — идентификатор [облака](../../resource-manager/concepts/resources-hierarchy.md#cloud), для которого собрана детализация.
* `cloud_name` — имя облака.
* `folder_id` — идентификатор каталога.
* `folder_name` — имя каталога на момент выгрузки детализации. Значение поля может быть пустым, если вы удалили каталог до выгрузки детализации.
* `resource_id` — (только для регулярного экспорта) идентификатор ресурса, имя ресурса или идентификатор подписки. Значение поля может быть пустым, если использование сервиса относится ко всему каталогу или не содержит ресурсов. Соответствие сервисов и значения столбца `resource_id`:
   * Compute Cloud и Cloud Marketplace — идентификатор виртуальной машины, снимка диска, образа диска или другого ресурса, установленного через Cloud Marketplace.
   * Object Storage — имя бакета.
   * Virtual Private Cloud — идентификатор ресурса, работающего с входящим или исходящим трафиком.
   * KMS — идентификатор ключа.
   * Network Load Balancer — идентификатор балансировщика.
   * Container Registry — идентификатор контейнера.
   * Kubernetes — идентификатор кластера.
   * Managed Service for PostgreSQL, Managed Service for ClickHouse®, Managed Service for MySQL®, Yandex Managed Service for Valkey™ и Managed Service for Apache Kafka® — идентификатор хоста в кластере.
   * Cloud Functions — идентификатор функции.
   * Monitoring — пустое значение.
   * 
   * Техническая поддержка — идентификатор подписки.
* `service_id` — идентификатор сервиса, которому принадлежит потребленный продукт.
* `service_name` — имя сервиса, которому принадлежит потребленный продукт.
* `sku_id` — идентификатор потребленного продукта.
* `sku_name` — имя продукта.
* `date` — дата, за которую начислена стоимость потребления. Дата определяется как диапазон с 0:00 до 23:59 по московскому времени (UTC +3).
* `currency` — валюта платежного аккаунта. Возможные значения: `RUB`, `USD` и `KZT`.
* `pricing_quantity` — количество потребленных единиц продукта. Десятичный разделитель — точка.
* `pricing_unit` — единица измерения потребления продукта.
* `cost` — общая стоимость потребления. Десятичный разделитель — точка.
* `credit` — сумма скидок. Не учитывается в общей стоимости потребления (`credit`). Всегда отрицательна. Десятичный разделитель — точка.
* `monetary_grant_credit` — скидка по гранту, в том числе по гранту на знакомство с платформой. Десятичный разделитель — точка.
* `volume_incentive_credit` — скидка за объем потребления продукта. Десятичный разделитель — точка.
* `cud_credit` — скидка за [резервированное потребление](../concepts/cvos.md) ресурса. Стоимость объема потребления сверх резервированного будет равна сумме значений столбцов `cost` и `credit`. Десятичный разделитель — точка.
* `misc_credit` — остальные виды скидок, в том числе скидки за потребление ресурсов после окончания действия гранта на знакомство с платформой, но до перехода на платную версию. Десятичный разделитель — точка.
* `label.user_labels.<имя_метки>` — метки, проставленные ресурсам. Как управлять метками описано в разделе [Управление метками](../../resource-manager/operations/manage-labels.md).
* `locale` — язык каждой строки в выгрузке. От значения поля зависит язык столбца `sku_name`. Возможные значения: `en` и `ru`.
* `updated_at` — дата и время последнего изменения строки в формате [Unix Timestamp](https://www.unixtimestamp.com).
* `exported_at` — дата и время добавления строки в файл детализации в формате [ISO 8601](https://ru.wikipedia.org/wiki/ISO_8601). Например, `2025-03-03T23:41:19Z`.

{% cut "Устаревшие параметры" %}

* `created_at` — дата и время, в которое начислена указанная стоимость потребления. В формате [Unix Timestamp](https://www.unixtimestamp.com).
* `label.system_labels.folder_id` — идентификатор каталога. Теперь значение отображается в столбце `folder_id`.

{% endcut %}


#### Полезные ссылки {#see-also}

[Посмотреть детализацию для облака](check-charges.md)

_ClickHouse® является зарегистрированным товарным знаком [ClickHouse, Inc](https://clickhouse.com)._