# Лимиты

Ограничения Just Run приходят с четырех разных уровней: конфигурации одной песочницы, квоты активного аккаунта, доступных сейчас ресурсов узла и операционных настроек конкретной инсталляции. Перед изменением запроса или повтором определите, какой именно уровень сработал.

## Модель ограничений[​](#limit-model "Прямая ссылка на Модель ограничений")

| Уровень                           | Пример                                                                               | Как узнать                                                   |
| --------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------ |
| Граница одной песочницы           | 1–8 vCPU                                                                             | Публичный контракт на этой странице и ошибка валидации       |
| Настройка шаблона или инсталляции | Значения ресурсов по умолчанию, максимальный таймаут, размер загрузки в теле запроса | Прочитать созданный ресурс и ответ с ошибкой                 |
| Квота аккаунта                    | Суммарные песочницы, vCPU, RAM и хранилище                                           | Дашборд и эндпоинты потребления аккаунта                     |
| Текущие ресурсы узлов             | Свободные CPU и память здоровых узлов                                                | Это не квота; создание или возобновление может вернуть `503` |

Нахождение ниже квоты аккаунта не резервирует ресурсы узла. И наоборот, временная нехватка ресурсов узла не означает, что квота аккаунта израсходована.

## Ресурсы одной песочницы[​](#per-sandbox-resources "Прямая ссылка на Ресурсы одной песочницы")

API создания и переопределения холодного возобновления принимают:

| Ресурс    | Допустимое значение                       | Примечание                                                                            |
| --------- | ----------------------------------------- | ------------------------------------------------------------------------------------- |
| `vcpu`    | 1–8                                       | Целое число vCPU                                                                      |
| `ram_mb`  | 128–8192                                  | Память в МиБ                                                                          |
| `disk_mb` | Эффективный диапазон платформы 2048–65536 | Минимум шаблона и инсталляции либо меньший максимум инсталляции могут сузить диапазон |

Если при создании не указаны vCPU или RAM, используется значение шаблона по умолчанию, затем значение инсталляции по умолчанию. Минимум шаблона может поднять значение по умолчанию. Явные vCPU и RAM вне публичного диапазона возвращают HTTP `400`.

Корневой диск устроен иначе: и явные значения, и значение по умолчанию приводятся к минимуму шаблона и максимуму инсталляции. Диск может вырасти из образа шаблона только при создании, а изменить его размер позднее нельзя. Фактический размер читайте из `disk_mb` в ответе.

vCPU и RAM меняются только через остановку и возобновление с переопределениями. Новые значения подчиняются тем же границам и требуют свободных ресурсов узла. См. [Настройка песочницы](/sandboxes/configure-a-sandbox.md).

## Проверка квоты аккаунта[​](#inspect-account-quota "Прямая ссылка на Проверка квоты аккаунта")

Обзор в дашборде показывает количество песочниц, vCPU, RAM и использование корневых дисков песочниц. Те же значения возвращает `GET /v1/account/overview`:

```
curl --fail-with-body --silent --show-error \
  "$JUSTRUN_API/v1/account/overview" \
  --header "Authorization: Bearer $JUSTRUN_PAT" |
  jq '.quotas'
```

Форма ответа:

```
{
  "limits": {
    "max_sandboxes": 0,
    "max_total_vcpu": 0,
    "max_total_ram_mb": 0,
    "max_storage_gb": 0
  },
  "used": {
    "sandboxes": 0,
    "vcpu": 0,
    "ram_mb": 0,
    "storage_bytes": 0
  }
}
```

Нули здесь показывают поля, а не реальные значения квоты. Лимиты зависят от инсталляции и аккаунта, поэтому всегда используйте актуальный ответ.

Количество песочниц, суммарные vCPU и RAM проверяются при создании песочницы. Параллельные запросы создания резервируют запрошенные ресурсы, поэтому не могут все пройти по одному и тому же остатку бюджета. Ровно достичь лимита можно, а запрос, который его превысит, возвращает HTTP `429`.

`max_storage_gb` и `storage_bytes` описывают корневые диски песочниц. Контроль этого дискового бюджета может зависеть от инсталляции, поэтому считайте актуальные значения информацией о потреблении и обрабатывайте возможный `429`, не предполагая единую политику.

## У хранилища аккаунта отдельная квота[​](#account-storage-has-a-separate-quota "Прямая ссылка на У хранилища аккаунта отдельная квота")

Когда хранилище аккаунта включено, проверяйте его независимый бюджет:

```
curl --fail-with-body --silent --show-error \
  "$JUSTRUN_API/v1/storage/usage" \
  --header "Authorization: Bearer $JUSTRUN_PAT" |
  jq '{bytes_used, pending_bytes, quota_bytes, object_count, reconciled_at}'
```

`pending_bytes` — оптимистичные списания для неистекших presigned PUT URL. Запись отвергается с HTTP `429`, если текущие байты, ожидающие байты и входящий объект превысят `quota_bytes`. Удаление или перезапись меньшим объектом может пройти, потому что освобождает место.

Не сравнивайте `quota_bytes` с `max_storage_gb`: они относятся к разным системам хранения. См. [Постоянные данные и хранилище](/sandboxes/persistence-and-storage.md).

## Временные ограничения[​](#time-limits "Прямая ссылка на Временные ограничения")

Есть два независимых таймаута:

* `timeout_ms` песочницы задает окно истечения ресурса песочницы;
* `timeout` команды задает максимальное время одного выполнения с буферизацией или со стримингом.

Инсталляция может задать значение истечения песочницы по умолчанию и максимальный допустимый `timeout_ms`. Положительное значение выше максимума возвращает HTTP `400`; неположительное эффективное значение означает отсутствие истечения. Проверяйте примененное поведение по `timeout_ms` и `expires_at` в ответе песочницы. Возобновление и пробуждение запускают окно истечения заново.

Поле REST `/exec` и `/exec-stream` называется `timeout`, измеряется в миллисекундах и без значения или при нуле по умолчанию равно пяти минутам. В MCP `sandbox_exec` соответствующий аргумент называется `timeout_ms`.

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

## Операционные границы[​](#operational-boundaries "Прямая ссылка на Операционные границы")

| Что ограничено                                                       | Граница                                                                                   |
| -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `stdin` для `/exec` с буферизацией                                   | Base64-ввод после декодирования не больше 2 МиБ                                           |
| Список содержимого каталога в API файлов                             | Запрошенная глубина ограничивается 32; результат обрезается на 50 000 записей             |
| Загрузка файлов и тело HTTP-запроса                                  | Настраиваются в инсталляции; шлюз и сервис внутри песочницы могут задавать разные пределы |
| Передача в теле запроса и размер объекта в хранилище аккаунта        | Настраиваются в инсталляции; для крупных передач используйте presigned URL                |
| Страница списка хранилища                                            | `limit` приводится к 1–1000, значение по умолчанию 100                                    |
| Опубликованный порт                                                  | Целое число 1–65535; порт `0` недопустим                                                  |
| Одновременные процессы, терминалы и наблюдатель за файловой системой | Ограничены конфигурацией среды выполнения песочницы                                       |
| Частота API-запросов                                                 | Настройки инсталляции по IP и по аккаунту могут вернуть `429`                             |

Обрезка списка содержимого каталога — не постраничная выдача. Сузьте путь или глубину, если полный обход может превысить 50 000 записей.

При выполнении с буферизацией весь stdout и stderr возвращается одним ответом. Для долгой работы или большого вывода предпочитайте [SSE-стриминг или фоновый процесс](/sandboxes/commands-processes-and-terminals.md).

## Разбор отклоненного запроса[​](#diagnose-a-rejected-request "Прямая ссылка на Разбор отклоненного запроса")

| Статус | Вероятный уровень                                                              | Действие                                                                                                                    |
| ------ | ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| `400`  | Недопустимый ресурс песочницы, таймаут, порт или поле запроса                  | Исправьте запрос; повтор без изменения снова завершится ошибкой                                                             |
| `413`  | Слишком большое тело запроса, файл в теле или передача объекта                 | Используйте стриминг или presigned-путь либо уменьшите содержимое запроса                                                   |
| `429`  | Квота ресурсов аккаунта, квота хранилища или частота запросов                  | Прочитайте тело ошибки и актуальную квоту; освобождайте ресурс, а ждать имеет смысл только при ограничении частоты запросов |
| `503`  | Нет свободных ресурсов подходящего здорового узла или недоступен нужный бэкенд | Повторите с интервалом между повторами; уменьшайте ресурсы, только если это допустимо                                       |

Не повторяйте каждый `429` вслепую. Отказ по квоте останется, пока не изменится потребление или лимит аккаунта, а ограничение частоты запросов временно. Аналогично, уменьшение запрошенных ресурсов может помочь размещению, но меняет контракт рабочей нагрузки.

## Планирование с учетом переменных лимитов[​](#plan-for-variable-limits "Прямая ссылка на Планирование с учетом переменных лимитов")

* Читайте эффективные ресурсы из ответов на создание и возобновление.
* Проверяйте потребление аккаунта и хранилища перед крупными параллельными пакетами запросов.
* Ограничивайте конкурентность клиента, даже если каждый запрос валиден.
* Используйте ключ идемпотентности для запросов создания, которые могут быть повторены.
* Оставляйте запас для восстановления и замены рабочей нагрузки.
* Считайте значения конфигурации по умолчанию в одном окружении деталями инсталляции, а не публичными гарантиями.

## Связанные разделы[​](#related "Прямая ссылка на Связанные разделы")

* [Создание песочницы](/sandboxes/create-a-sandbox.md)
* [Настройка песочницы](/sandboxes/configure-a-sandbox.md)
* [Жизненный цикл песочницы](/sandboxes/lifecycle.md)
* [Постоянные данные и хранилище](/sandboxes/persistence-and-storage.md)
* [Команды, процессы и терминалы](/sandboxes/commands-processes-and-terminals.md)
* [Наблюдаемость и диагностика](/sandboxes/observability-and-troubleshooting.md)
* [Основы работы с API](/developers/api-fundamentals.md)
