Skip to main content
Je kunt een time-out bij inactiviteit configureren voor je sandboxes, zodat ze automatisch worden gestopt of gepauzeerd wanneer er geen actieve verbindingen worden gedetecteerd. Dit helpt kosten te verlagen door ervoor te zorgen dat ongebruikte sandboxes niet onbeperkt blijven draaien.
De time-out bij inactiviteit wordt geconfigureerd via het veld metadata bij het maken van een sandbox. De sleutel is idle_timeout en de waarde is het aantal seconden (als een string).

Basisgebruik

Geef de sleutel idle_timeout door in het object metadata bij het maken van een sandbox. De waarde is de duur van de time-out bij inactiviteit in seconden (als een string). Wanneer er gedurende de opgegeven duur geen client met de sandbox is verbonden, wordt de sandbox automatisch beëindigd of gepauzeerd.

Hoe time-out bij inactiviteit werkt

De functie voor time-out bij inactiviteit bewaakt actieve verbindingen met je sandbox:
  1. Wanneer er geen verbindingen actief zijn — wordt de eindtijd van de sandbox ingesteld op current_time + idle_timeout_seconds.
  2. Wanneer een verbinding weer actief wordt — wordt de eindtijd van de sandbox hersteld naar de oorspronkelijke maximale levensduur van de sandbox.
  3. Wanneer de time-out bij inactiviteit verstrijkt zonder opnieuw verbinding te maken — wordt de sandbox beëindigd (of gepauzeerd als autoPause is ingeschakeld).
Dit betekent dat een sandbox niet wordt gestopt zolang er ten minste één actieve client mee verbonden is (bijv. via Sandbox.connect() of open WebSocket/HTTP-verbindingen).

Pauzeren in plaats van beëindigen

Standaard wordt een inactieve sandbox beëindigd wanneer de time-out bij inactiviteit verloopt. Als je wilt dat de sandbox in plaats daarvan wordt gepauzeerd, zodat je deze later kunt hervatten, schakel dan de optie autoPause in:
Wanneer autoPause is ingeschakeld, gaat de sandboxstatus bij een time-out door inactiviteit over naar paused. Je kunt later connect om de uitvoering te hervatten.

Combineren met andere metadata

De metadatasleutel idle_timeout kan worden gecombineerd met andere metadatasleutels die je mogelijk al gebruikt:

Beperkingen voor time-outs

Als je idle_timeout instelt op een waarde onder de minimumdrempel (30 seconden), wordt de functie voor time-out bij inactiviteit stilzwijgend uitgeschakeld voor die sandbox. De sandbox blijft draaien totdat de maximale levensduur is verstreken.

Time-out bij inactiviteit uitschakelen

Om de time-out bij inactiviteit voor een sandbox expliciet uit te schakelen, laat je simpelweg de sleutel idle_timeout weg uit de metadata, of stel je deze in op "0":

Veelvoorkomende use-cases

Kortdurende uitvoeringstaken

Gebruik een korte time-out bij inactiviteit voor sandboxes die eenmalige taken uitvoeren en niet hoeven te blijven bestaan nadat de client de verbinding verbreekt:

Langlopende interactieve sessies

Gebruik een langere time-out bij inactiviteit voor sandboxes die worden gebruikt in interactieve sessies waarbij gebruikers tijdelijk kunnen weggaan:
Laatst gewijzigd op 10 augustus 2026