Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
ppio.sandbox.connect() 方法连接到正在运行或已暂停的 Sandbox,并继续通过 SDK 控制它。
这在以下场景中很有用:在多次 serverless 函数调用之间复用同一个 Sandbox 实例、恢复用户的 Web 应用会话、重新连接到长时间运行的任务,或在短暂闲置后恢复已暂停的 Sandbox。
ppio.sandbox.list() 获取,然后将其传入 ppio.sandbox.connect()。
from ppio_sandbox import PPIO, SandboxQuery, SandboxState
ppio = PPIO()
# --- 获取 Sandbox ID ---
# 获取所有运行中的 Sandbox
running_sandboxes_paginator = ppio.sandbox.list(query=SandboxQuery(state=[SandboxState.RUNNING]))
running_sandboxes = running_sandboxes_paginator.next_items()
if len(running_sandboxes) == 0:
raise Exception("No running sandboxes found")
running_sandbox_id = running_sandboxes[0].sandbox_id
# --- 连接到 Sandbox ---
sandbox = ppio.sandbox.connect(running_sandbox_id)
print("connected to sandbox: ", sandbox.sandbox_id)
# 现在可以照常使用该 Sandbox
# ...
sandbox.kill()
import { PPIO, SandboxState } from 'ppio-sandbox'
const ppio = new PPIO()
// --- 获取 Sandbox ID ---
// 获取所有运行中的 Sandbox
const runningSandboxesPaginator = await ppio.sandbox.list({
query: {
state: [SandboxState.RUNNING],
},
})
const runningSandboxes = await runningSandboxesPaginator.nextItems()
if (runningSandboxes.length === 0) {
throw new Error('No running sandboxes found')
}
const runningSandboxId = runningSandboxes[0].sandboxId
// --- 连接到 Sandbox ---
const sandbox = await ppio.sandbox.connect(runningSandboxId)
console.log('connected to sandbox: ', sandbox.sandboxId)
// 现在可以照常使用该 Sandbox
// ...
# 将交互式终端连接到运行中的 Sandbox（别名：sandbox cn）
ppio sandbox connect <sandboxID>