Перейти к основному содержимому
Открыть Markdown

Лимиты

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

Модель ограничений​

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

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

Ресурсы одной песочницы​

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

РесурсДопустимое значениеПримечание
vcpu1–8Целое число vCPU
ram_mb128–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 вслепую. Отказ по квоте останется, пока не изменится потребление или лимит аккаунта, а ограничение частоты запросов временно. Аналогично, уменьшение запрошенных ресурсов может помочь размещению, но меняет контракт рабочей нагрузки.

Планирование с учетом переменных лимитов​

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