Лимиты
Ограничения Just Run приходят с четырех разных уровней: конфигурации одной песочницы, квоты активного аккаунта, доступных сейчас ресурсов узла и операционных настроек конкретной инсталляции. Перед изменением запроса или повтором определите, какой именно уровень сработал.
Модель ограничений
| Уровень | Пример | Как узнать |
|---|---|---|
| Граница одной песочницы | 1–8 vCPU | Публичный контракт на этой странице и ошибка валидации |
| Настройка шаблона или инсталляции | Значения ресурсов по умолчанию, максимальный таймаут, размер загрузки в теле запроса | Прочитать созданный ресурс и ответ с ошибкой |
| Квота аккаунта | Суммарные песочницы, vCPU, RAM и хранилище | Дашборд и эндпоинты потребления аккаунта |
| Текущие ресурсы узлов | Свободные CPU и память здоровых узлов | Это не квота; создание или возобновление может вернуть 503 |
Нахождение ниже квоты аккаунта не резервирует ресурсы узла. И наоборот, временная нехватка ресурсов узла не означает, что квота аккаунта израсходована.
Ресурсы одной песочницы
API создания и переопределения холодного возобновления принимают:
| Ресурс | Допустимое значение | Примечание |
|---|---|---|
vcpu | 1–8 | Целое число vCPU |
ram_mb | 128–8192 | Память в МиБ |
disk_mb | Эффективный диапазон платформы 2048–65536 | Минимум шаблона и инсталляции либо меньший максимум инсталляции могут сузить диапазон |
Если при создании не указаны vCPU или RAM, используется значение шаблона по умолчанию, затем
значение инсталляции по умолчанию. Минимум шаблона может поднять значение по умолчанию. Явные vCPU и RAM
вне публичного диапазона возвращают HTTP 400.
Корневой диск устроен иначе: и явные значения, и значение по умолчанию приводятся к минимуму
шаблона и максимуму инсталляции. Диск может вырасти из образа шаблона только
при создании, а изменить его размер позднее нельзя. Фактический размер читайте
из disk_mb в ответе.
vCPU и RAM меняются только через остановку и возобновление с переопределениями. Новые значения подчиняются тем же границам и требуют свободных ресурсов узла. См. Настройка песочницы.
Проверка квоты аккаунта
Обзор в дашборде показывает количество песочниц, 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, не предполагая
единую политику.
У хранилища аккаунта отдельная квота
Когда хранилище аккаунта включено, проверяйте его независимый бюджет:
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: они относятся к разным системам
хранения. См. Постоянные данные и хранилище.
Временные ограничения
Есть два независимых таймаута:
timeout_msпесочницы задает окно истечения ресурса песочницы;timeoutкоманды задает максимальное время одного выполнения с буферизацией или со стримингом.
Инсталляция может задать значение истечения песочницы по умолчанию и максимальный допустимый
timeout_ms. Положительное значение выше максимума возвращает HTTP 400;
неположительное эффективное значение означает отсутствие истечения. Проверяйте
примененное поведение по timeout_ms и expires_at в ответе песочницы. Возобновление и
пробуждение запускают окно истечения заново.
Поле REST /exec и /exec-stream называется timeout, измеряется в
миллисекундах и без значения или при нуле по умолчанию равно пяти минутам. В
MCP sandbox_exec соответствующий аргумент называется timeout_ms.
Таймаут не гарантирует отмену внешних побочных эффектов. Делайте команды идемпотентными и при необходимости задавайте сетевым клиентам собственные, более короткие предельные сроки.
Операционные границы
| Что ограничено | Граница |
|---|---|
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-стриминг или фоновый процесс.
Разбор отклоненного запроса
| Статус | Вероятный уровень | Действие |
|---|---|---|
400 | Недопустимый ресурс песочницы, таймаут, порт или поле запроса | Исправьте запрос; повтор без изменения снова завершится ошибкой |
413 | Слишком большое тело запроса, файл в теле или передача объекта | Используйте стриминг или presigned-путь либо уменьшите содержимое запроса |
429 | Квота ресурсов аккаунта, квота хранилища или частота запросов | Прочитайте тело ошибки и актуальную квоту; освобождайте ресурс, а ждать имеет смысл только при ограничении частоты запросов |
503 | Нет свободных ресурсов подходящего здорового узла или недоступен нужный бэкенд | Повторите с интервалом между повторами; уменьшайте ресурсы, только если это допустимо |
Не повторяйте каждый 429 вслепую. Отказ по квоте останется, пока не изменится
потребление или лимит аккаунта, а ограничение частоты запросов временно. Аналогично, уменьшение
запрошенных ресурсов может помочь размещению, но меняет контракт рабочей нагрузки.
Планирование с учетом переменных лимитов
- Читайте эффективные ресурсы из ответов на создание и возобновление.
- Проверяйте потребление аккаунта и хранилища перед крупными параллельными пакетами запросов.
- Ограничивайте конкурентность клиента, даже если каждый запрос валиден.
- Используйте ключ идемпотентности для запросов создания, которые могут быть повторены.
- Оставляйте запас для восстановления и замены рабочей нагрузки.
- Считайте значения конфигурации по умолчанию в одном окружении деталями инсталляции, а не публичными гарантиями.