Skip to main content
Mit Sandbox-Persistenz können Sie eine Sandbox pausieren und später mit demselben Dateisystem- und Speicherzustand fortsetzen. Dies ist nützlich für langlaufende Agentenaufgaben, interaktive Apps und Workflows, die Leerlaufzeiten überstehen müssen, ohne Rechenressourcen aktiv zu halten. Wenn eine Sandbox pausiert wird:
  • In der Sandbox erstellte Dateien bleiben erhalten.
  • Der In-Memory-Zustand bleibt erhalten, einschließlich laufender Prozesse und Variablen.
  • Netzwerkverbindungen werden unterbrochen, bis die Sandbox fortgesetzt wird.
  • Die Sandbox bleibt gespeichert, bis Sie sie fortsetzen und beenden oder sie beenden, während sie pausiert ist.
Informationen zum automatischen Pausieren bei Zeitüberschreitung und zum automatischen Fortsetzen bei Aktivität finden Sie unter Automatisches Pausieren und Fortsetzen. Informationen zum Leerlauf-Timeout finden Sie unter Leerlauf-Timeout.
Bitte beachten Sie:
  • 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 erhalten, bis Sie explizit die Methode kill aufrufen.

Eine Sandbox pausieren

Sie können die Methode pause aufrufen, wenn Sie den aktuellen Zustand speichern möchten.

Eine Sandbox fortsetzen

Verwenden Sie die gespeicherte Sandbox-ID, um erneut eine Verbindung herzustellen. Wenn die Sandbox pausiert ist, können Sie die Methode connect verwenden, um sie fortzusetzen, bevor sie zurückgegeben wird.
Sie können beim erneuten Verbinden ein neues timeout übergeben.
Bei einer laufenden Sandbox wird das Timeout nur aktualisiert, wenn das neue Timeout länger ist als das vorhandene. Bei einer pausierten Sandbox gilt das Timeout nach dem Fortsetzen.

Pausierte Sandboxes auflisten

Sie können die Methode list mit einem Statusfilter verwenden, um pausierte Sandboxes zu finden. Weitere Informationen zur Verwendung der Methode finden Sie unter Sandboxes auflisten.
Metadatenfilter sind nützlich, wenn Sie Sandboxes finden müssen, die von einem bestimmten Benutzer, einer bestimmten Sitzung oder einem bestimmten Job erstellt wurden.

Eine pausierte Sandbox löschen

Pausierte Sandboxes bleiben gespeichert, bis Sie sie entfernen. Sie können die Methode kill verwenden, um pausierte Sandboxes zu entfernen, die Sie nicht mehr benötigen.

Persistenz vs. Snapshots

Persistenz dient dazu, dieselbe Sandbox später fortzusetzen. Verwenden Sie sie, wenn Ihnen die genaue Sandbox-ID und der aktuelle Laufzeitstatus wichtig sind. Snapshots dienen dazu, wiederverwendbare gespeicherte Zustände zu erstellen. Verwenden Sie einen Snapshot, wenn Sie eine oder mehrere neue Sandboxes aus demselben erfassten Dateisystem- und Speicherzustand starten möchten. Informationen zu wiederverwendbaren Zuständen finden Sie unter Sandbox-Snapshot.

Netzwerk

Wenn Sie eine Sandbox pausieren, in der ein Dienst ausgeführt wird, ist der Dienst von außerhalb der Sandbox nicht mehr erreichbar, und alle verbundenen Clients werden getrennt. Nachdem Sie die Sandbox fortgesetzt haben, ist der Dienst wieder erreichbar, aber Clients müssen sich erneut verbinden.
Zuletzt geändert am 10. August 2026