VK Private Cloud logo
Помощь
Обновлена 17 июля 2026 г. в 15:55

Отчёт о статистике потребления сервисов

Отчёт о статистике потребления сервисов содержит транзакции по инстансам сервисов.

Чтобы получить отчёт о статистике потребления сервисов, выполните запрос с параметрами из таблицы 1.

Таблица 1 — Параметры запроса на получение отчёта

Параметр

Значение

Обязательный

Метод запроса

GET

Отчёт о статистике потребления сервисов

Путь запроса

https://<CLOUD_HOST>/marketplace/api/gg/api/v1/reports/usage

Здесь <CLOUD_HOST> — доменное имя Платформы

Отчёт о статистике потребления сервисов

date_start

Задаётся в пути запроса.

Определяет дату начала периода, за который будет сформирован отчёт. Укажите месяц и год. Например, 10.2023

Отчёт о статистике потребления сервисов

date_end

Задаётся в пути запроса.

Определяет дату окончания периода, за который будет сформирован отчёт. Укажите месяц и год. Например, 11.2023

Отчёт о статистике потребления сервисов

instance_type

Задаётся в пути запроса.

Определяет сервис, по которому будет сформирован отчёт. Укажите значение параметра slug из ответа на запрос конфигурации сервиса (по ID и ревизии сервиса).

Отчёт о статистике потребления сервисов

Authorization

<TARIFFICATOR_SERVICE_TOKEN> — токен доступа к сервису Tarifficator.

Соответствует значению переменной окружения GLOMGOLD_COMMON__SERVICETOKEN подов развёртывания xaas-infra-api, а также значению секрета для ключа glomgold-common&#8212;&#8203;servicetoken из плейбука helm-xaas

Отчёт о статистике потребления сервисов

Чтобы отчёт был сохранён локально в CSV-файл, в запросе укажите команду -o report.csv.

Пример запроса на получение отчёта по всем сервисам Marketplace
$ curl -v 'https://<CLOUD_HOST>/marketplace/api/gg/api/v1/reports/usage?date_start=10.2023&amp;date_end=11.2023' \-H 'Authorization: Bearer <TARIFFICATOR_SERVICE_TOKEN>' \-o report.csv

HTTP-коды ответа приведены в таблице 2.

Таблица 2 — HTTP-коды ответа

Код

Описание

200

ОК

400

Некорректный запрос

401

Ошибка аутентификации

404

Объект не найден

500

Внутренняя ошибка сервера