Пагинация и фильтрация

В API v2 списочные методы ориентированы на простую автоматизацию и UI‑сценарии.

Базовый подход

Там, где это поддерживается, используйте:

• limit
• offset

Это наиболее удобная схема для Console, простых backoffice‑интеграций и административных скриптов.

Полезные фильтры для баз

Для списка баз tenant в текущем публичном сценарии особенно полезны:

• state
• name_prefix
• limit
• offset

Это позволяет:

• отфильтровать только ready, stopped или error базы;
• быстро искать базы по техническому префиксу;
• строить paginated‑списки в UI и внутренних инструментах.

Практические советы

• не делайте слишком большие limit без необходимости;
• при автоматизации сначала фильтруйте по tenant, затем уже по state или имени;
• считайте состав списка динамическим: между запросами состояние ресурсов может меняться из-за auto‑start / auto‑stop или асинхронного удаления.

Для большинства пользовательских сценариев этой модели достаточно: она проста, предсказуема и хорошо подходит для каталогов ресурсов.