Що вважається простоєм
Пісочниця простоює, поки в ній нічого не відбувається: немає викликів у неї й відкритих потоків, відкритих посилань, SSH-сесій чи запитів до її портів, не йде хід агента й не виконується команда, запущена з keep_awake. Сам лише фоновий процес не тримає її пробудженою: коли пісочниця стає на паузу, процес заморожується разом із нею й продовжує після пробудження. Кожен сервер перевіряє всі свої пісочниці щосекунди.
Три таймери: автопауза, автозупинка, автовидалення
pause_after_idle_seconds, типово 300: пісочниця, що працює, стає на паузу зі збереженням пам’яті й процесів, за 30 % ціни роботи.stop_after_idle_seconds, типово 1800: пісочниця, що працює або на паузі, зупиняється; процеси завершуються, а диск переходить в об’єктне сховище за 0,03 $ за GiB власних даних на місяць.delete_after_idle_seconds, типово 0, тобто ніколи: пісочниця в будь-якому стані видаляється.
Усі три йдуть за одним годинником — часом, що минув відтоді, як у пісочниці щось відбувалося востаннє. Таймер зупинки, не пізніший за таймер паузи, зупиняє пісочницю, що працює, без паузи. get_sandbox каже, що життєвий цикл зробить далі й коли, у next_state і next_state_time. Таймери задаються під час створення пісочниці, потім змінюються через update_sandbox, а шаблон може передавати їх кожній пісочниці, створеній із нього.
from pethost.sandboxes import Lifecycle, Sandboxes, SandboxSettings
sandboxes = Sandboxes() # читає PETHOST_TOKEN
lifecycle = Lifecycle(
pause_after_idle_seconds=60, # пауза після хвилини простою
stop_after_idle_seconds=3600, # зупинка після години простою
delete_after_idle_seconds=7 * 86400, # видалення після тижня простою
)
sandbox = sandboxes.create_sandbox("base", settings=SandboxSettings(lifecycle=lifecycle))
# Робота, до якої ніхто не звертається, поки вона йде: keep_awake відкладає паузу, щонайбільше на годину.
install = "python3 -m venv env && env/bin/pip install pandas scikit-learn"
sandboxes.run_command(sandbox.sandbox_id, command=install, keep_awake=True, timeout_seconds=3600, wait_seconds=0)id=$(pethost sandbox new --pause-after 1m --stop-after 1h --delete-after 168h)
pethost sandbox run "$id" --keep-awake --timeout 1h -d -- 'python3 -m venv env && env/bin/pip install pandas scikit-learn'Коли серверу бракує ресурсів
Сервер може поставити на паузу чи зупинити пісочниці раніше за їхні таймери. Коли йому бракує пам’яті, він ставить на паузу пісочниці, що працюють і простоюють хвилину або довше; коли бракує диска, зупиняє пісочниці на паузі, що простоюють найдовше. Нічого не втрачається в жодному разі: пісочниця на паузі прокидається, як будь-яка інша, зупинена знову запускається зі свого диска, а state_message пояснює, чому це сталося.
Пробудження зупиненої пісочниці
Виклик до зупиненої пісочниці типово відхиляється (FAILED_PRECONDITION зі Stopped), а на запит до її порту приходить відповідь 503, доки resume_sandbox її не запустить. Коли ввімкнено wake_when_stopped, зупинена пісочниця прокидається від виклику, входу по SSH чи запиту до порту, як і пісочниця на паузі: приблизно за 0,2 с або приблизно за 10 с на GiB, коли її диск треба повернути з об’єктного сховища. Тоді її vCPU зараховуються в тариф і поки вона зупинена. Це підходить пісочниці, яку час від часу викликає вебхук.
Скільки коштує простій
Жодна пісочниця не має максимального часу життя: та, якій не дають заснути, працює, доки ви її не зупините, а та, яку лишили в спокої, на кожному кроці коштує менше. Візьмімо одну пісочницю SMALL, у якій агент працює 2 години на день, а решту 22 вона простоює, протягом місяця на 30 днів. Якщо в простої вона на паузі, це 4,64 $ використання: 60 годин по 0,018 $ і 660 по 0,0054 $. Якби вона весь час працювала, вийшло б 12,96 $. Якщо в простої вона зупинена, з 5 GiB власних даних, це 1,22 $, але тоді кожен запуск завантажує її з диска, а процеси зникають. Посекундна оплата пояснює, як рахується кожна з цих секунд.
Порівняння з іншими
Інші постачальники обмежують, скільки живе пісочниця. За їхніми сторінками на 21 листопада 2026 року сесії E2B тривають до 1 години на Hobby і до 24 годин на Pro, а пауза запускає відлік наново; пісочниці Modal живуть типово 5 хв і щонайбільше 24 години; а сесії Vercel Sandbox тривають 45 хв на Hobby і 24 години на Pro. Pethost не ставить жодної межі: пісочниця стає на паузу й зупиняється за своїми таймерами та живе, доки її не приберете ви або заданий вами таймер видалення.