Відхилити або обмежити запит до резервування грошей
Напишіть політику — умови, за якими перевіряється запит, і що відбувається, коли вони виконуються, — розставте політики за порядком і перевірте на них запит.
5 хв читання
Політика — це правило, яке застосовується до запиту до того, як гроші зарезервовано. Вона відхиляє запит або змінює його ліміти. Ця сторінка — про сторінку політик у консолі.
Де розташовані політики
Відкрийте Налаштування, потім Політики. Сторінка показує політики кожного проєкту, який вам доступний, і ті, що діють на всі проєкти, — у порядку, в якому вони перевіряються.
Рядок показує назву політики, де вона діє, її пріоритет і саме правило, прочитане одним реченням.
Сторінка відкривається тому, хто має дозвіл management:read. Для створення, зміни та видалення політики потрібен management:write. Політику, яка діє на всі проєкти, змінює лише учасник, якому доступний кожен проєкт.
Як перевіряється запит
Slen перевіряє запит за ввімкненими політиками його проєкту та за ввімкненими політиками, які діють на всі проєкти. Це відбувається до перевірки бюджетів і до резервування грошей.
Першою перевіряється політика з найвищим пріоритетом.
Політика застосовується, коли виконуються всі її умови. Політика без умов застосовується до кожного запиту.
Перша політика, яка відмовляє, зупиняє запит. Запит завершується з кодом
policy_denied, а повідомлення помилки називає політику.Політика, яка змінює ліміт, перевірку не зупиняє. Політики після неї перевіряються далі.
Умови
| Умова | Як порівнюється | Що порівнюється |
|---|---|---|
| Витрачено | Не менше, не більше | Скільки проєкт витратив із першого дня місяця |
| Вартість запиту | Не менше, не більше | Оцінка вартості запиту |
| Операцій у роботі | Не менше, не більше | Кількість резервів, які проєкт тримає в цей момент |
| Модель | Дорівнює, одна з | Код моделі запиту |
| Операція | Дорівнює | Код операції запиту |
| Провайдер | Дорівнює | Провайдер моделі |
| Кінцевий клієнт | Дорівнює | Id вашого клієнта, якого називає запит |
| Час доби | Між | Час, коли надходить запит, у вибраному вами часовому поясі. Вікно, яке закінчується раніше, ніж починається, переходить через північ |
Дії
| Дія | Що вона робить |
|---|---|
| Відхилити запит | Відхиляє кожен запит, до якого застосовується політика |
| Дозволити запит | Сама нічого не змінює. Політики після неї перевіряються далі, і бюджети діють, як і раніше |
| Дозволити лише ці моделі | Відхиляє запит, моделі якого немає у списку |
| Обмежити вартість одного виклику | Відхиляє запит, оцінка вартості якого вища за стелю |
| Змінити коефіцієнт запасу | Задає, на що множиться оцінка, щоб отримати резерв. За 1.5 резерв у півтора раза більший за оцінку. Коли застосовується кілька таких політик, вирішує та, яку перевірено першою |
| Змінити стелю вихідних токенів | Знижує кількість вихідних токенів, яку запит може запросити, — ще до того, як оцінено його вартість |
Змінити стелю вихідних токенів застосовується до того, як відомі вартість і провайдер запиту. Давайте такій політиці лише умови Модель, Операція, Кінцевий клієнт і Час доби. З будь-якою іншою умовою політика не зберігається — ні в консолі, ні через API. Політика цього виду, яка вже має іншу умову, не застосовується ніколи.
Написати політику
1. Почніть нову політику
Натисніть Нова політика.
2. Назвіть політику
Причина відмови цитує назву, тому скажіть у ній, для чого політика. Назва може бути завдовжки до 120 символів.
3. Виберіть, де вона діє
У полі Застосовується до виберіть проєкт або Усі проєкти організації. Другий варіант пропонується лише учасникові, якому доступний кожен проєкт. Після збереження політики змінити, де вона діє, не можна.
4. Додайте умови
У розділі Коли виберіть, що порівнюється, як і з яким значенням. Натисніть Додати умову, щоб додати ще одну. Форма не зберігає політику, поки якась умова не має значення. Видаліть усі умови, щоб політика застосовувалася до кожного запиту.
5. Виберіть дію
У розділі Тоді виберіть дію й заповніть її значення. Форма не зберігає політику, поки значення не того виду: моделі — це список кодів через кому, стеля вартості — сума, записана з крапкою й не більше ніж вісьмома знаками після неї, коефіцієнт запасу — число, більше за 0 і менше за 1000, не більше ніж із трьома знаками, а стеля вихідних токенів — ціле число від 1.
6. Задайте пріоритет
Відкрийте Порядок застосування й задайте Пріоритет — ціле число від 0 до 1000. У нової політики він дорівнює 100. Відмова зупиняє запит, тому суворій політиці дайте більше число.
7. Створіть політику
Натисніть Створити політику.
Нова політика ввімкнена й діє вже на наступний запит. Політика, яка відхиляє й не має умов, відхиляє кожен запит там, де вона діє.
Вимкнути, змінити або видалити політику
Перемикач у рядку політики підписано Увімкнена. Вимкніть його — і запити більше не перевірятимуться за цією політикою, а її налаштування збережуться. У меню рядка — Змінити та Видалити.
Перевірити запит
Натисніть Перевірити запит, виберіть Проєкт, з якого надходить запит, і заповніть запит: модель, операцію, провайдера, оцінку вартості, час і кінцевого клієнта. Панель відповідає Дозволено або Відхилено, називає причину й каже щодо кожної політики, що вона зробила.
Перевірка виконується у вашому браузері. Нічого не надсилається, і нічого не витрачається.
Перевірка проходить по політиках, які зустрічає справжній запит вибраного проєкту: по політиках цього проєкту й тих, що діють на всі проєкти.
Політика з умовою Витрачено або Операцій у роботі залежить від живих лічильників, тому панель її не оцінює й каже про це.
Політика, яка змінює стелю вихідних токенів і має умову, якої вона не бачить, позначається як така, що ніколи не застосовується.
Що читати далі
Глосарій — що таке оцінка, резерв і бюджет.
Журнал аудиту — хто створив, змінив або видалив політику.
Коди помилок — кожен код API — що він означає і що робити.
Бюджети — обмежити витрати за період; бюджети перевіряються після політик.