Skip to main content
サンドボックスの永続化により、サンドボックスを一時停止し、後で同じファイルシステムとメモリ状態で再開できます。これは、長時間実行されるエージェントタスク、インタラクティブアプリ、アイドル期間をまたいで継続する必要があるワークフローにおいて、コンピュートリソースをアクティブなままにせずに状態を保持したい場合に便利です。 サンドボックスが一時停止されると:
  • サンドボックス内で作成されたファイルは保持されます。
  • 実行中のプロセスや変数を含む、メモリ内の状態が保持されます。
  • サンドボックスが再開されるまで、ネットワーク接続は中断されます。
  • サンドボックスは、再開して kill するか、一時停止中に kill するまで保存されたままになります。
タイムアウト時の自動一時停止と、アクティビティ発生時の自動再開については、Auto Pause and Resume を参照してください。アイドルタイムアウトについては、Idle timeout を参照してください。
注意:
  • サンドボックスの一時停止には、RAM 1 GB あたり約 4 秒かかります。
  • サンドボックスの再開には、約 1 秒かかります。
  • 一時停止されたサンドボックスのデータは、kill メソッドを明示的に呼び出すまで保持されます。

サンドボックスを一時停止する

現在の状態を保存したい場合は、pause メソッドを呼び出すことができます。

サンドボックスを再開する

保存済みのサンドボックス ID を使用して再接続します。サンドボックスが一時停止されている場合は、返す前に connect メソッドを使用して再開できます。
再接続時に新しい timeout を渡すことができます。
実行中のサンドボックスでは、新しいタイムアウトが既存のタイムアウトより長い場合にのみ、タイムアウトが更新されます。一時停止中のサンドボックスでは、再開後にタイムアウトが適用されます。

一時停止中のサンドボックスを一覧表示する

一時停止中のサンドボックスを見つけるには、状態フィルター付きで list メソッドを使用できます。このメソッドの使用方法の詳細については、List Sandboxes を参照してください。
特定のユーザー、セッション、またはジョブによって作成されたサンドボックスを見つける必要がある場合、メタデータフィルターが便利です。

一時停止中のサンドボックスを削除する

一時停止中のサンドボックスは、削除するまで保存されたままになります。不要になった一時停止中のサンドボックスを削除するには、kill メソッドを使用できます。

永続化とスナップショットの違い

永続化は、同じサンドボックスを後で継続するためのものです。正確なサンドボックス ID と現在の実行状態が重要な場合に使用します。 スナップショットは、再利用可能な保存済み状態を作成するためのものです。同じ取得済みのファイルシステムとメモリ状態から、1 つ以上の新しいサンドボックスを開始したい場合は、スナップショットを使用します。 再利用可能な状態については、Sandbox Snapshot を参照してください。

ネットワーク

実行中のサービスがあるサンドボックスを一時停止すると、そのサービスはサンドボックス外部からアクセスできなくなり、接続中のクライアントは切断されます。サンドボックスを再開すると、サービスは再びアクセス可能になりますが、クライアントは再接続する必要があります。
最終更新日 2026年8月10日