Skip to main content
Du kannst einen Leerlauf-Timeout für deine Sandboxes konfigurieren, damit sie automatisch gestoppt oder pausiert werden, wenn keine aktiven Verbindungen erkannt werden. Dies hilft, Kosten zu reduzieren, indem sichergestellt wird, dass ungenutzte Sandboxes nicht unbegrenzt weiterlaufen.
Der Leerlauf-Timeout wird beim Erstellen einer Sandbox über das Feld metadata konfiguriert. Der Schlüssel ist idle_timeout und der Wert ist die Anzahl der Sekunden (als String).

Grundlegende Verwendung

Übergebe den Schlüssel idle_timeout im Objekt metadata, wenn du eine Sandbox erstellst. Der Wert ist die Dauer des Leerlauf-Timeouts in Sekunden (als String). Wenn für die angegebene Dauer kein Client mit der Sandbox verbunden ist, wird die Sandbox automatisch beendet oder pausiert.

So funktioniert der Leerlauf-Timeout

Die Leerlauf-Timeout-Funktion überwacht aktive Verbindungen zu deiner Sandbox:
  1. Wenn keine Verbindungen aktiv sind — die Endzeit der Sandbox wird auf current_time + idle_timeout_seconds gesetzt.
  2. Wenn eine Verbindung wieder aktiv wird — die Endzeit der Sandbox wird auf die ursprüngliche maximale Sandbox-Lebensdauer zurückgesetzt.
  3. Wenn der Leerlauf-Timeout ohne erneute Verbindung abläuft — die Sandbox wird beendet (oder pausiert, wenn autoPause aktiviert ist).
Das bedeutet, dass eine Sandbox nicht gestoppt wird, solange mindestens ein aktiver Client mit ihr verbunden ist (z. B. über Sandbox.connect() oder offene WebSocket/HTTP-Verbindungen).

Pausieren statt Beenden

Standardmäßig wird eine im Leerlauf befindliche Sandbox beendet, wenn der Leerlauf-Timeout abläuft. Wenn du möchtest, dass die Sandbox stattdessen pausiert wird, damit du sie später fortsetzen kannst, aktiviere die Option autoPause:
Wenn autoPause aktiviert ist, wechselt der Sandbox-Zustand bei einem Leerlauf-Timeout zu paused. Du kannst dich später damit verbinden, um die Ausführung fortzusetzen.

Kombination mit anderen Metadaten

Der Metadaten-Schlüssel idle_timeout kann mit anderen Metadaten-Schlüsseln kombiniert werden, die du möglicherweise bereits verwendest:

Timeout-Einschränkungen

Wenn du idle_timeout auf einen Wert unterhalb des Mindestschwellenwerts (30 Sekunden) setzt, wird die Leerlauf-Timeout-Funktion für diese Sandbox still deaktiviert. Die Sandbox läuft weiter, bis ihre maximale Lebensdauer abläuft.

Leerlauf-Timeout deaktivieren

Um den Leerlauf-Timeout für eine Sandbox explizit zu deaktivieren, lasse den Schlüssel idle_timeout einfach aus den Metadaten weg oder setze ihn auf "0":

Häufige Anwendungsfälle

Kurzlebige Ausführungsaufgaben

Verwende einen kurzen Leerlauf-Timeout für Sandboxes, die einmalige Aufgaben ausführen und nach dem Trennen der Client-Verbindung nicht weiter bestehen müssen:

Lang laufende interaktive Sitzungen

Verwende einen längeren Leerlauf-Timeout für Sandboxes, die in interaktiven Sitzungen genutzt werden, bei denen Benutzer vorübergehend abwesend sein können:
Zuletzt geändert am 10. August 2026