Skip to main content
Version: 1.6.0

Квоты

Запись таблицы Квота (mai_quota) задает объем кредитов, который лицензия может израсходовать за период. У лицензии может быть несколько квот на разные периоды, например помесячные квоты на год вперед. Периоды квот одной лицензии не пересекаются. Действующая квота – квота в статусе Активная.

Потребители лицензии обслуживаются, только пока у нее есть действующая квота. Если действующей квоты нет, все нексусы блокируются для всех потребителей лицензии независимо от режима контроля лицензии. Значение квоты – ее объем вместе с дополнительной квотой: на форме квоты это поле Суммарная квота, а если дополнительной квоты нет – поле Объем. Что происходит, когда потребление достигает значения квоты, определяет поле Режим контроля лицензий на форме лицензии. Неизрасходованный остаток на следующую квоту не переносится.

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

Периоды и статусы квоты​


Квота действует с 00:00 даты начала до 00:00 даты окончания по часовому поясу лицензии. Дата окончания в период не входит: квота с 1 ноября по 1 декабря действует до конца 30 ноября, а следующая квота может начинаться 1 декабря.

СтатусКогда устанавливаетсяЧто можно изменить
ОжиданиеКвота создана с датой начала в будущем.Все поля. Квоту можно удалить.
АктивнаяНаступила дата начала. Квота, созданная с сегодняшней датой начала, сразу получает этот статус.Только поле Дополнительная квота.
ИстекшаяНаступила дата окончания.Квота доступна только для чтения.

Добавление квоты​


tip

Требуемые роли:

  • Чтение – mai_reporter, а также владельцы лицензии.
  • Создание – mai_admin.
  • Обновление – mai_admin и владельцы лицензии, для квоты в статусе Ожидание. Поле Дополнительная квота – mai_admin, для квоты в статусах Ожидание и Активная.
  • Удаление – mai_admin и владельцы лицензии, для квоты в статусе Ожидание.

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

  1. Откройте запись лицензии.
  2. В связанном списке Квота нажмите Добавить.
  3. В окне Добавить квоту в лицензию заполните поля. Чтобы подставить параметры из шаблона, установите флажок Из шаблона и выберите шаблон в поле Шаблон квоты. Подставленные значения можно изменить.
  4. Нажмите Добавить. Чтобы одновременно сохранить параметры как новый шаблон, нажмите Добавить и сохранить как шаблон: кнопка отображается, если шаблон не выбран или его значения изменены.

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

Квоту нельзя добавить, если:

  • дата начала или окончания раньше сегодняшней по часовому поясу лицензии;
  • дата начала совпадает с датой окончания или позже нее;
  • период пересекается с периодом другой квоты лицензии;
  • лицензия удаляется.

Поля окна Добавить квоту в лицензию​

ПолеОбязательноОписание
Дата началаДаУкажите дату начала квоты.
Дата окончанияДаУкажите дату окончания квоты. Дата не входит в период.

Поле заполняется автоматически, если заполнено поле Продолжительность: дата начала плюс продолжительность в днях.

Из шаблонаНетУстановите флажок, чтобы заполнить поля окна из шаблона квоты.
Шаблон квотыНетВыберите шаблон квоты.

Поле отображается, если установлен флажок Из шаблона.

Значение квотыДа/НетУкажите объем квоты в кредитах на весь срок. Значение должно быть больше 0.

Поле обязательно и доступно, если флажок Неограниченно снят.

ПродолжительностьДаУкажите срок квоты в днях, не меньше 1.

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

НеограниченноНетУстановите флажок, чтобы создать квоту без ограничения объема. Поле Значение квоты очищается. Неограниченная квота не исчерпывается.
ПериодическаяНетУстановите флажок, чтобы разбить срок на несколько квот, по одной на период.

Последний период заканчивается датой окончания и может быть короче остальных. Каждая квота, кроме последней, получает значение поля Значение квоты на период, последняя – остаток значения квоты. Например, значение 1000 на 3 периода дает квоты 333, 333 и 334.

Единица измерения продолжительности периодаДа/НетВыберите длину периода. Доступные опции:
  • День – 1 день;
  • Неделя – 7 дней;
  • Месяц – 30 дней;
  • Квартал – 91 день;
  • Год – 365 дней.
Если установлен флажок Привязать к календарю, период – календарная неделя, месяц, квартал или год.

Поле отображается и обязательно, если установлен флажок Периодическая.

Привязать к календарюНетУстановите флажок, чтобы границы периодов совпадали с началом календарной недели, месяца, квартала или года. Первая квота длится от даты начала до начала следующей календарной единицы, например с 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 года.

Объем первой и последней квоты задайте по условиям договора.

Увеличение действующей квоты​


Даты и объем действующей квоты доступны только для чтения. Чтобы увеличить объем в текущем периоде, заполните поле Дополнительная квота:

  1. Откройте запись квоты из связанного списка Квота на форме лицензии.
  2. В поле Дополнительная квота укажите общий объем пополнений квоты. Если квоту уже пополняли, прибавьте новые кредиты к текущему значению поля: например, при текущем значении 10 000 и пополнении на 20 000 укажите 30 000.
  3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Поле Суммарная квота пересчитывается автоматически. Если потребление было заблокировано из-за исчерпания квоты, блокировка снимается после ближайшего пересчета потребления. В режиме Ограничение скорости после пересчета снова действуют обычные лимиты частоты запросов.

Увеличение квоты не снимает блокировку по правилу квоты: правило ограничивает потребление независимо от значения квоты.

Поля формы Квота​

ПолеОбязательноОписание
ЛицензияДаЛицензия, к которой относится квота. Поле заполняется автоматически при добавлении квоты с формы лицензии и доступно только для чтения.
ОбъемНетУкажите объем квоты в кредитах. Значение должно быть больше 0. Если поле не заполнено, квота не ограничена.

Поле доступно для изменения в статусе Ожидание.

Дополнительная квотаНетУкажите общий объем пополнений квоты в кредитах. Суммарная квота должна быть больше значения поля Использовано, иначе значение не сохраняется.

Поле отображается, если заполнено поле Объем, и доступно для изменения в статусах Ожидание и Активная.

Дата началаДаУкажите дату начала квоты.

Поле доступно для изменения в статусе Ожидание.

Дата окончанияДаУкажите дату окончания квоты. Дата не входит в период.

Поле доступно для изменения в статусе Ожидание.

СтатусДаСтатус квоты. Поле заполняется автоматически и доступно только для чтения. Возможные значения:
  • Ожидание;
  • Активная;
  • Истекшая.
Читайте подробнее в разделе Периоды и статусы квоты.
ИспользованоНетПотребление лицензии в кредитах за период квоты. Поле заполняется автоматически при пересчете потребления и доступно только для чтения.
Суммарная квотаНетСумма полей Объем и Дополнительная квота. Поле заполняется автоматически и доступно только для чтения.

Поле отображается, если заполнены оба поля.

Шаблоны квот​


Запись таблицы Шаблон квоты (mai_quota_template) хранит параметры квоты без дат: объем, продолжительность и разбиение на периоды. Шаблон выбирается в окне Добавить квоту в лицензию и подставляет свои значения в поля окна. Дату начала указывают при каждом добавлении квоты.

Если в шаблоне установлен флажок Привязать к календарю, шаблон не хранит значение поля Значение квоты на период: число календарных периодов зависит от дат, поэтому окно рассчитывает значение при добавлении квоты.

Шаблон можно сохранить при добавлении квоты кнопкой Добавить и сохранить как шаблон или создать в списке шаблонов:

  1. Перейдите в навигаторе в Управление инсталляциями приложений (MAI) → Управление лицензиями и квотами → Шаблон квоты.
  2. Нажмите Создать и заполните поля формы. Поля совпадают с одноименными полями окна Добавить квоту в лицензию, кроме дат и выбора шаблона. Поле Значение квоты на период на форме шаблона также заполняется автоматически и доступно только для чтения.
  3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Название шаблона формируется автоматически из продолжительности, объема и периода, например 90 days, Total 300000, Every month 100000. У шаблона с привязкой к календарю вместо значения на период в названии указано by calendar, например 365 days, Total 1200000, Every month, by calendar.