Удаление tenant

Stable

Как работает удаление tenant и почему его нужно рассматривать как асинхронную деструктивную операцию.

Обновлено: 5 марта 2026 г.

Удаление tenant — деструктивная операция: вместе с ним может удаляться набор БД и связанное durable‑состояние.

Базовое правило

Если внутри tenant ещё есть базы, используйте каскадный сценарий:

DELETE /v2/tenants/:tenant?cascade=true

В UI чаще используется более осторожный путь: сначала удалить базы, затем сам tenant.

Что происходит после запроса

Удаление не всегда завершается мгновенно. Обычно платформа:

  • переводит ресурс в промежуточное состояние;
  • останавливает активный compute, если он ещё работает;
  • очищает storage‑сущности;
  • удаляет запись tenant из каталога.

Поэтому сразу после запроса tenant может ещё некоторое время быть виден в системе.

Когда удаление не сработает

Типовые причины:

  • у токена нет can_delete;
  • ресурс уже удаляется;
  • внутри tenant ещё есть базы, а каскадный режим не указан.

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

Перед удалением tenant убедитесь, что:

  • нужные данные уже не используются приложениями;
  • зависимости проверены;
  • команда понимает последствия.

Для production‑ресурсов это особенно важно: удалить tenant проще, чем потом восстанавливать логику использования.