# Создание песочницы

Создайте песочницу из шаблона. Минимальному запросу нужно только имя шаблона: ресурсы берутся из настроек шаблона и инсталляции, а песочница, созданная без собственного имени, получает читаемое — например, `brave-otter-d805`. Новые песочницы через REST и веб-интерфейс личные для автора внутри организации. Передайте `"visibility": "org"` в REST-запросе, если доступ нужен другим участникам. Старые песочницы остаются общими; созданные через E2B — личные. URL превью — отдельная ссылка доступа; личная видимость ее не отзывает.

## Перед началом[​](#before-you-begin "Прямая ссылка на Перед началом")

Нужны право создания в активном аккаунте и доступный шаблон. REST-клиенту потребуется персональный токен с правами *Полные*.

Решите, будет ли песочница одноразовой. Дайте ей понятное имя и не передавайте учетные данные напрямую, если подходит переиспользуемый [секрет](/secrets.md).

## Создание через веб-интерфейс[​](#create-through-the-web-ui "Прямая ссылка на Создание через веб-интерфейс")

1. Откройте *Песочницы* → *Новая песочница* и выберите карточку каталога.
2. Задайте *Имя песочницы* или оставьте поле пустым — имя будет сгенерировано. В организации выберите видимость *Личный* или *Для организации*.
3. Если в форме есть блок *Нужно для запуска*, заполните обязательные поля. Для секрета выберите сохраненный секрет типа *Окружение* с этой переменной или введите новое значение и нажмите *Сохранить ключ*: форма сохранит его как новый секрет типа *Окружение* и подключит к этой песочнице.
4. Проверьте сводку: vCPU, RAM, диск и поведение автопаузы.
5. Раскрывайте *Дополнительные настройки*, только если нужно сменить шаблон или его версию, vCPU, память, диск, доступ к хранилищу, пробуждение по запросу, автопаузу, переменные, *Секреты*, *MCP-серверы*, *Навыки* или *Внешний доступ к песочнице*.
6. Нажмите *Создать песочницу*.

Веб-интерфейс откроет страницу новой песочницы.

## Создание через REST API[​](#create-through-the-rest-api "Прямая ссылка на Создание через REST API")

```
curl --fail-with-body --silent --show-error \
  --request POST "$JUSTRUN_API/v1/sandboxes" \
  --header "Authorization: Bearer $JUSTRUN_PAT" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: create-my-worker-1" \
  --data '{
    "template": "base",
    "name": "my-worker",
    "vcpu": 1,
    "ram_mb": 512
  }' |
  jq
```

Поддерживается 1–8 vCPU и 128–8192 МиБ RAM. Корневой диск можно увеличить относительно размера шаблона, но нельзя уменьшить.

Пресет может объявить обязательные поля. Чтобы создать песочницу из конкретного пресета, передайте его `id` из `GET /v1/presets` строкой в `preset_id`; без него применяется пресет шаблона по умолчанию. Шлюз проверяет обязательные поля после слияния `env` пресета, подключенных секретов и `env` запроса (`env` запроса важнее) и отклоняет отсутствующее или пустое значение, а также значение вне вариантов поля выбора, с HTTP `422` и нарушением с указателем `/env/<NAME>`. VM в этом случае не создается.

Используйте уникальный ключ идемпотентности для одной логической операции. Повторяйте его только при повторе того же запроса создания после неопределенного ответа.

## Проверка результата[​](#verify-the-result "Прямая ссылка на Проверка результата")

Создание возвращает HTTP `201`, `id` и `status`. Текущее состояние можно получить:

```
curl --fail-with-body --silent --show-error \
  "$JUSTRUN_API/v1/sandboxes/$SANDBOX_ID" \
  --header "Authorization: Bearer $JUSTRUN_PAT" |
  jq '{id, status, template, vcpu, ram_mb, provisioning}'
```

Дождитесь `status: "running"`. Если есть блок `provisioning`, также дождитесь `provisioning.status: "ready"` перед использованием клонированного репозитория или другого подготовленного артефакта. `failed` — терминальное состояние, а шаги укажут отказавший компонент подготовки.

## Для рабочей среды[​](#production-considerations "Прямая ссылка на Для рабочей среды")

* Создание расходует квоты песочницы, vCPU, RAM и хранилища активного аккаунта. Превышение квоты возвращает `429`.
* Если нет здорового узла с достаточными ресурсами, API возвращает `503`.
* Unix-пользователь по умолчанию — непривилегированный `user`. Запрашивайте `root` только при необходимости.
* Удаление одноразовой песочницы отличается от остановки: остановка сохраняет ресурс.

## См. также[​](#related "Прямая ссылка на См. также")

* [Выбор шаблона](/templates/choose-a-template)
* [Настройка песочницы](/sandboxes/configure-a-sandbox.md)
* [Быстрый старт с API](/getting-started/api.md)
* [Наблюдаемость и диагностика](/sandboxes/observability-and-troubleshooting.md)
