slen.ai
Начать

Задать потолок трат на период

Создайте бюджет, выберите его период и то, что он охватывает, смотрите, сколько от него осталось, меняйте его и отправляйте в архив.

3 мин чтения

Бюджет — это потолок того, что можно потратить за период. Каждый холд, который берёт вызов модели, проверяется по бюджетам, которые его охватывают, и вызов, который не помещается, отклоняется до обращения к провайдеру. Эта страница — о странице бюджетов в консоли; сам холд объясняет статья Как работает резервирование бюджета.

Где находятся бюджеты

Откройте Бюджеты. Страница показывает бюджеты проекта, выбранного в шапке, и бюджеты всей организации. Счета клиентов — в отдельном разделе Клиенты бокового меню.

Бюджеты читает каждая роль. Для создания, изменения и отправки бюджета в архив нужно management:write: в консоли оно есть у ролей Владелец и Администратор — Организации, проекты и роли. Журнал аудита записывает каждое из этих изменений.

Создать бюджет

1. Начните новый бюджет

Нажмите Создать.

2. Назовите его

Название необязательно, и именно его показывает список. Без названия список показывает период и то, что охватывает бюджет.

3. Выберите период

В поле Период выберите Ежедневно, Еженедельно, Ежемесячно или За всё время. Бюджет на день, неделю или месяц начинается заново со следующим, и строка говорит когда. Бюджет За всё время заново не начинается никогда.

4. Выберите, что он охватывает

В поле Применяется к выберите Этот проект или Вся организация. Второй вариант предлагается только участнику, которому доступен каждый проект. Бюджет всей организации считает траты каждого её проекта.

5. Задайте лимит

Заполните Лимит — сумму в валюте организации, не больше восьми знаков после точки: 3000 или 12.50.

6. Сузьте его до одной операции

Чтобы ограничить только вызовы одной операции, откройте Дополнительно и заполните код операции. Оставьте его пустым для бюджета на все вызовы.

7. Создайте бюджет

Нажмите Создать бюджет. Следующий холд проверяется уже по нему.

Период, то, что охватывает бюджет, и его код операции потом изменить нельзя: траты, учтённые под ними, за изменением не последуют. Вместо этого создайте другой бюджет.

Прочитать список

  • Полоса в строке заполняется тем, что ещё доступно, рядом с лимитом.

  • Точка в строке зелёная, пока использовано меньше 80 % лимита, жёлтая — от 80 %, и красная, когда бюджет израсходован. Сумма холдов считается использованной, как и списанное.

  • На операцию и Одновременные резервы — бюджеты ещё двух видов, они создаются через API. Первый отклоняет один холд больше своего лимита, второй считает холды, открытые одновременно, — Как работает резервирование бюджета.

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

Изменить, отправить в архив или восстановить бюджет

Нажмите на строку, чтобы открыть бюджет. Списано, В резерве и Доступно показывают, как используется лимит в текущем периоде.

  • Измените название или Лимит и нажмите Сохранить. Новый лимит действует со следующего холда. Лимит ниже того, что период уже использовал, принимается, и тогда ни один новый холд не помещается, пока период не начнётся заново или лимит не поднимут.

  • В архив после подтверждения исключает бюджет из новых холдов. Уже взятые холды по-прежнему рассчитываются.

  • Бюджеты в архиве свёрнуты внизу списка. Восстановить в строке возвращает бюджет.

Бюджет всей организации меняет только тот, кому доступен каждый проект. API-ключ действует в своём проекте, поэтому такое изменение через API отклоняется с кодом project_access_restricted.

Узнать заранее, что бюджет кончается

  • Slen отправляет событие вебхука budget.threshold_reached, когда холд доводит использование бюджета до 50 % и до 80 % его лимита, и budget.exceeded, когда оно доходит до всего лимита. О каждом уровне сообщается не больше одного раза за период, а холд, который проходит сразу два уровня, сообщает только о более высоком. Бюджеты видов На операцию и Одновременные резервы таких событий не отправляют.

  • Правило оповещения типа Порог бюджета следит за долей, которую вы выбираете, — Оповещения.

Что читать дальше