Skip to main content
Diese Legacy-Seite wird für Benutzer beibehalten, die noch die SDK-Reihe 1.x oder die Beta-SDK-Reihe verwenden. Neue SDK-2.x-Integrationen sollten der aktuellen Sandbox-Dokumentation folgen.
Mit der Sandbox-Persistenz kannst du deine Sandbox pausieren und später in demselben Zustand fortsetzen, in dem sie sich beim Pausieren befand. Dies umfasst nicht nur den Zustand des Dateisystems der Sandbox, sondern auch den Speicher der Sandbox. Das bedeutet: alle laufenden Prozesse, geladenen Variablen, Daten usw.
Bitte beachte:
  • Das Pausieren der Sandbox dauert etwa 4 Sekunden pro 1 GB RAM.
  • Das Fortsetzen der Sandbox dauert etwa 1 Sekunde.
  • Die Daten einer pausierten Sandbox bleiben dauerhaft erhalten, bis du explizit die Methode kill aufrufst.

Sandbox pausieren

Wenn du eine Sandbox pausierst, werden sowohl das Dateisystem der Sandbox als auch ihr Speicherzustand gespeichert. Dazu gehören alle Dateien im Dateisystem der Sandbox sowie alle laufenden Prozesse, geladenen Variablen, Daten usw.
Hinweis: Kurze Übergangsphase nach dem PausierenDas Pausieren ist ein asynchroner Vorgang. Nach dem Aufruf von beta_pause() pausiert die Sandbox im Hintergrund.Während dieser Übergangsphase, bevor das Pausieren abgeschlossen ist:
  • Nur-Lese-Operationen (z. B. get_info, list): werden normal zurückgegeben; der Status wird als paused angezeigt
  • Ausführungsoperationen (z. B. commands.run, Zugriff auf öffentliche Sandbox-URLs): geben Fehler zurück — das ist erwartetes Verhalten. Warte, bis das Pausieren abgeschlossen ist, bevor du es erneut versuchst (die Dauer variiert je nach Speichergröße, siehe Hinweis oben)
  • Fortsetzungsoperation (connect): wartet automatisch, bis das Pausieren abgeschlossen ist, bevor die Sandbox fortgesetzt wird — kein manuelles Polling oder erneutes Versuchen erforderlich

Sandbox fortsetzen

Wenn du eine Sandbox fortsetzt, befindet sie sich in demselben Zustand, in dem sie sich beim Pausieren befand. Das bedeutet, dass alle Dateien im Dateisystem der Sandbox wiederhergestellt werden und alle laufenden Prozesse, geladenen Variablen, Daten usw. wiederhergestellt werden.
Wenn du connect() unmittelbar nach dem Aufruf von beta_pause() aufrufst, wartet connect() automatisch, bis das Pausieren abgeschlossen ist, bevor die Sandbox fortgesetzt wird. Es ist kein manuelles Polling erforderlich — der gesamte Vorgang ist für den Aufrufer transparent.
Wenn du versuchst, eine Sandbox fortzusetzen, die zerstört wurde oder nicht existiert:
  • Das JavaScript SDK löst NotFoundError aus
  • Das Python SDK löst NotFoundException aus

Pausierte Sandboxes auflisten

Du kannst alle pausierten Sandboxes auflisten, indem du die Methode Sandbox.list aufrufst und den Query-Parameter state angibst. Weitere Informationen zur Verwendung der Methode findest du unter List Sandboxes.

Pausierte Sandboxes entfernen

Du kannst pausierte Sandboxes entfernen, indem du die Methode kill auf der Sandbox-Instanz aufrufst.

Timeout der Sandbox

Wenn du eine Sandbox fortsetzt, wird der Timeout der Sandbox auf den Standard-Timeout einer Sandbox zurückgesetzt - 5 Minuten. Du kannst der Methode Sandbox.connect() wie folgt einen benutzerdefinierten Timeout übergeben:

Netzwerk

Wenn ein Dienst (zum Beispiel ein Server) innerhalb deiner Sandbox läuft und du die Sandbox pausierst, ist der Dienst von außen nicht erreichbar und alle Clients werden getrennt. Wenn du die Sandbox fortsetzt, ist der Dienst wieder erreichbar, aber du musst die Clients erneut verbinden.
Zuletzt geändert am 10. August 2026