Лимиты и доступ
В консоли в разделе Настройки → Лимиты и доступ собраны бюджеты и правила доступа для всей команды. Они защищают от неожиданных расходов и от злоупотреблений, если API-ключ утечёт.
Менять эти правила могут только владельцы и администраторы команды. Каждое изменение записывается в Историю изменений в правом верхнем углу страницы.
Лимит бюджета
Бюджеты задаются на трёх уровнях — команда, участник, API-ключ. Период: День, Месяц или Всего.
- Бюджет команды: лимит расходов всей команды
- Бюджет участника по умолчанию: считается для каждого участника отдельно; если участнику задан индивидуальный бюджет, действует он
- Бюджет ключа: задаётся для отдельного ключа на странице API-ключи
Уровни считаются независимо: как только исчерпан любой из них, запрос блокируется. В пределах одного периода бюджет ключа не может превышать бюджет его участника, а бюджет участника — бюджет команды.
Для каждого бюджета можно выбрать режим:
Пополнение баланса не возобновляет вызовы после исчерпания бюджета. Нужно повысить лимит или дождаться сброса дневного / месячного периода.
Список IP
Разрешает вызовы только с указанных IPv4-адресов или CIDR-диапазонов, до 100 записей. Запросы с адресов не из списка отклоняются.
- Список IP команды: действует для всех API-ключей команды
- Список IP ключа: дополнительно сужает список команды для отдельного ключа; адрес из списка ключа действует, только если он есть и в списке команды
Удобно, чтобы привязать production-ключ к своим серверам: даже если ключ утечёт, вызвать его из другого места не получится.
Доступные модели
Для команды есть три режима, модели можно выбирать целиком по провайдеру:
Отдельный ключ можно ограничить ещё сильнее через «Доступные модели» в меню ключа. Правила команды и ключа действуют одновременно: вызвать можно только модель, разрешённую на обоих уровнях.
Проверить действующие правила
На ключ действуют сразу два уровня правил — команды и ключа. На странице API-ключи откройте меню ключа, нажмите Проверить действующие правила и выберите модель: вы увидите, будет ли вызов заблокирован, каким правилом и сколько осталось бюджета. Проверка не расходует кредиты.
Ответ при блокировке
Запрос, остановленный бюджетом или правилом доступа, не пройдёт и при повторе — сначала нужно изменить правила:
Заблокированные запросы видны на странице Активность с фильтром «Заблокировано». Полный список кодов ошибок — в разделе Обработка ошибок.
История изменений
Кто, когда и что менял в списке IP, доступных моделях и бюджетах, можно посмотреть в Истории изменений в правом верхнем углу раздела Лимиты и доступ. Изменения настроек хранения логов здесь не записываются, см. Логи запросов.