add_fine - начисление штрафов IP-адресам
17 апреля 2024
ID 249345
add_fine(Auth, client_id, resource_id, ip_list, fine, ttl)
Описание: метод начисляет IP-адресам переданный штраф, который будет активен указанное время.
Входные параметры:
client_id (int) - идентификатор клиента (целое число, от 1 до 4 294 967 295).
resource_id (int) - идентификатор ресурса (целое число, от 1 до 4 294 967 295), или -1 для всех ресурсов клиента.
ip_list (str) - набор IP-адресов в текстовом формате (CIDR, IP_first-IP_last, IP).
fine (int) - начисляемый штраф (целое число, от -100 до 100, кроме 0).
ttl (int) - время блокировки в секундах, в случае разблокировки - время доверия адресу (целое число, от 600 до 3600).
Примечание:
Количество IP-адресов должно быть от 1 до 256.
Запрещено добавлять IP-адрес: 0.0.0.0.
Результат:
Строка в JSON-нотации следующей структуры:
{ result (str) - OK или ERROR errors (dict): { <RESOURCE_ID_1>: [IP1, IP2, ...], //список уже заблокированных (при передачи fine > 0), либо <RESOURCE_ID_2>: [IP3, IP4, ...], //уже доверенных (при передаче fine < 0) IP-адресов для каждого ресурса ... } } |
Более подробно с алгоритмом работы системы штрафов можно ознакомиться в статье о Системе штрафов в KDP.