Квоты
Запись таблицы Квота (mai_quota) задает объем кредитов, который лицензия может израсходовать за период. У лицензии может быть несколько квот на разные периоды, например помесячные квоты на год вперед. Периоды квот одной лицензии не пересекаются. Действующая квота – квота в статусе Активная.
Потребители лицензии обслуживаются, только пока у нее есть действующая квота. Если действующей квоты нет, все нексусы блокируются для всех потребителей лицензии независимо от режима контроля лицензии. Значение квоты – ее объем вместе с дополнительной квотой: на форме квоты это поле Суммарная квота, а если дополнительной квоты нет – поле Объем. Что происходит, когда потребление достигает значения квоты, определяет поле Режим контроля лицензий на форме лицензии. Неизрасходованный остаток на следующую квоту не переносится.
Потребление считается в кредитах по правилам биллинга нексусов. Система пересчитывает потребление каждой квоты по журналу обращений раз в 5 минут, поэтому блокировка и ее снятие наступают с этой задержкой.
Периоды и статусы квоты
Квота действует с 00:00 даты начала до 00:00 даты окончания по часовому поясу лицензии. Дата окончания в период не входит: квота с 1 ноября по 1 декабря действует до конца 30 ноября, а следующая квота может начинаться 1 декабря.
| Статус | Когда устанавливается | Что можно изменить |
|---|---|---|
| Ожидание | Квота создана с датой начала в будущем. | Все поля. Квоту можно удалить. |
| Активная | Наступила дата начала. Квота, созданная с сегодняшней датой начала, сразу получает этот статус. | Только поле Дополнительная квота. |
| Истекшая | Наступила дата окончания. | Квота доступна только для чтения. |
Добавление квоты
Требуемые роли:
- Чтение – mai_reporter, а также владельцы лицензии.
- Создание – mai_admin.
- Обновление – mai_admin и владельцы лицензии, для квоты в статусе Ожидание. Поле Дополнительная квота – mai_admin, для квоты в статусах Ожидание и Активная.
- Удаление – mai_admin и владельцы лицензии, для квоты в статусе Ожидание.
Квота добавляется в окне на форме лицензии. В окне можно сразу создать несколько квот подряд, например помесячные квоты на год.
- Откройте запись лицензии.
- В связанном списке Квота нажмите Добавить.
- В окне Добавить квоту в лицензию заполните поля. Чтобы подставить параметры из шаблона, установите флажок Из шаблона и выберите шаблон в поле Шаблон квоты. Подставленные значения можно изменить.
- Нажмите Добавить. Чтобы одновременно сохранить параметры как новый шаблон, нажмите Добавить и сохранить как шаблон: кнопка отображается, если шаблон не выбран или его значения изменены.
В результате отображается сообщение Квота успешно добавлена, а квоты появляются в связанном списке Квота.
Квоту нельзя добавить, если:
- дата начала или окончания раньше сегодняшней по часовому поясу лицензии;
- дата начала совпадает с датой окончания или позже нее;
- период пересекается с периодом другой квоты лицензии;
- лицензия удаляется.

Поля окна Добавить квоту в лицензию
| Поле | Обязательно | Описание |
|---|---|---|
| Дата начала | Да | Укажите дату начала квоты. |
| Дата окончания | Да | Укажите дату окончания квоты. Дата не входит в период. Поле заполняется автоматически, если заполнено поле Продолжительность: дата начала плюс продолжительность в днях. |
| Из шаблона | Нет | Установите флажок, чтобы заполнить поля окна из шаблона квоты. |
| Шаблон квоты | Нет | Выберите шаблон квоты. Поле отображается, если установлен флажок Из шаблона. |
| Значение квоты | Да/Нет | Укажите объем квоты в кредитах на весь срок. Значение должно быть больше 0. Поле обязательно и доступно, если флажок Неограниченно снят. |
| Продолжительность | Да | Укажите срок квоты в днях, не меньше 1. Поле заполняется автоматически, если указаны даты начала и окончания. |
| Неограниченно | Нет | Установите флажок, чтобы создать квоту без ограничения объема. Поле Значение квоты очищается. Неограниченная квота не исчерпывается. |
| Периодическая | Нет | Установите флажок, чтобы разбить срок на несколько квот, по одной на период. Последний период заканчивается датой окончания и может быть короче остальных. Каждая квота, кроме последней, получает значение поля Значение квоты на период, последняя – остаток значения квоты. Например, значение 1000 на 3 периода дает квоты 333, 333 и 334. |
| Единица измерения продолжительности периода | Да/Нет | Выберите длину периода. Доступные опции:
Поле отображается и обязательно, если установлен флажок Периодическая. |
| Привязать к календарю | Нет | Установите флажок, чтобы границы периодов совпадали с началом календарной недели, месяца, квартала или года. Первая квота длится от даты начала до начала следующей календарной единицы, например с 13 августа до 1 сентября. Поле отображается, если установлен флажок Периодическая и выбрана единица, отличная от День. |
| Значение квоты на период | Нет | Объем квоты каждого периода, кроме последнего. Поле заполняется автоматически и доступно только для чтения: значение квоты делится на число периодов и округляется вниз. Число периодов окно рассчитывает по датам, полю Единица измерения продолжительности периода и флажку Привязать к календарю. Поле отображается, если установлен флажок Периодическая. |
Например, нужно задать годовой объем 1 200 000 кредитов по 100 000 в месяц. Укажите даты с 1 января по 1 января следующего года и значение квоты 1 200 000. Установите флажки Периодическая и Привязать к календарю и выберите единицу Месяц. Окно создает 12 квот по 100 000. Без флажка Привязать к календарю месяц длится 30 дней: год разбивается на 13 периодов, и значение на период получается меньше 100 000.
Если срок начинается не с первого числа месяца, при привязке к календарю первая квота длится только до конца месяца, а периодов становится на один больше. Значение на период получается меньше ожидаемого, и короткая первая квота получает столько же, сколько полные месяцы. Чтобы помесячные квоты получили полный объем, добавьте неполные месяцы отдельными квотами. Например, для договора с 15 марта 2027 года по 15 марта 2028 года по 100 000 кредитов в месяц добавьте:
- квоту с 15 марта по 1 апреля 2027 года;
- периодическую квоту с привязкой к календарю с 1 апреля 2027 года по 1 марта 2028 года со значением 1 100 000 – окно создает 11 квот по 100 000;
- квоту с 1 по 15 марта 2028 года.
Объем первой и последней квоты задайте по условиям договора.
Увеличение действующей квоты
Даты и объем действующей квоты доступны только для чтения. Чтобы увеличить объем в текущем периоде, заполните поле Дополнительная квота:
- Откройте запись квоты из связанного списка Квота на форме лицензии.
- В поле Дополнительная квота укажите общий объем пополнений квоты. Если квоту уже пополняли, прибавьте новые кредиты к текущему значению поля: например, при текущем значении 10 000 и пополнении на 20 000 укажите 30 000.
- Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.
Поле Суммарная квота пересчитывается автоматически. Если потребление было заблокировано из-за исчерпания квоты, блокировка снимается после ближайшего пересчета потребления. В режиме Ограничение скорости после пересчета снова действуют обычные лимиты частоты запросов.
Увеличение квоты не снимает блокировку по правилу квоты: правило ограничивает потребление независимо от значения квоты.

Поля формы Квота
| Поле | Обязательно | Описание |
|---|---|---|
| Лицензия | Да | Лицензия, к которой относится квота. Поле заполняется автоматически при добавлении квоты с формы лицензии и доступно только для чтения. |
| Объем | Нет | Укажите объем квоты в кредитах. Значение должно быть больше 0. Если поле не заполнено, квота не ограничена. Поле доступно для изменения в статусе Ожидание. |
| Дополнительная квота | Нет | Укажите общий объем пополнений квоты в кредитах. Суммарная квота должна быть больше значения поля Использовано, иначе значение не сохраняется. Поле отображается, если заполнено поле Объем, и доступно для изменения в статусах Ожидание и Активная. |
| Дата начала | Да | Укажите дату начала квоты. Поле доступно для изменения в статусе Ожидание. |
| Дата окончания | Да | Укажите дату окончания квоты. Дата не входит в период. Поле доступно для изменения в статусе Ожидание. |
| Статус | Да | Статус квоты. Поле заполняется автоматически и доступно только для чтения. Возможные значения:
|
| Использовано | Нет | Потребление лицензии в кредитах за период квоты. Поле заполняется автоматически при пересчете потребления и доступно только для чтения. |
| Суммарная квота | Нет | Сумма полей Объем и Дополнительная квота. Поле заполняется автоматически и доступно только для чтения. Поле отображается, если заполнены оба поля. |
Шаблоны квот
Запись таблицы Шаблон квоты (mai_quota_template) хранит параметры квоты без дат: объем, продолжительность и разбиение на периоды. Шаблон выбирается в окне Добавить квоту в лицензию и подставляет свои значения в поля окна. Дату начала указывают при каждом добавлении квоты.
Если в шаблоне установлен флажок Привязать к календарю, шаблон не хранит значение поля Значение квоты на период: число календарных периодов зависит от дат, поэтому окно рассчитывает значение при добавлении квоты.
Шаблон можно сохранить при добавлении квоты кнопкой Добавить и сохранить как шаблон или создать в списке шаблонов:
- Перейдите в навигаторе в Управление инсталляциями приложений (MAI) → Управление лицензиями и квотами → Шаблон квоты.
- Нажмите Создать и заполните поля формы. Поля совпадают с одноименными полями окна Добавить квоту в лицензию, кроме дат и выбора шаблона. Поле Значение квоты на период на форме шаблона также заполняется автоматически и доступно только для чтения.
- Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.
Название шаблона формируется автоматически из продолжительности, объема и периода, например 90 days, Total 300000, Every month 100000. У шаблона с привязкой к календарю вместо значения на период в названии указано by calendar, например 365 days, Total 1200000, Every month, by calendar.