- 将沙箱与用户会话关联。
- 为沙箱存储自定义用户数据，如 API 密钥。
- 将沙箱与用户 ID 关联并稍后需要重新 连进沙箱。
沙箱实例
元数据
沙箱元数据为附加在沙箱实例上的任意键值对信息。
适用于以下场景：
最后修改于 2026年8月31日
Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
import { Sandbox } from 'ppio-sandbox/code-interpreter'
// 创建沙箱并指定元数据。
const sandbox = await Sandbox.create({
metadata: {
userId: '123',
},
})
// 列出正在运行的沙箱并访问元数据。
const runningSandboxesPaginator = await Sandbox.list({
query: {
state: ["running"],
},
})
const runningSandboxes = await runningSandboxesPaginator.nextItems()
console.log("runningSandboxes[0].metadata: ", runningSandboxes[0].metadata)
// 输出示例：
// { userId: '123' }
await sandbox.kill()
from ppio_sandbox.code_interpreter import Sandbox, SandboxQuery, SandboxState
# 创建沙箱并指定元数据。
sandbox = Sandbox.create(
metadata={
'user_id': '123',
},
)
# 列出正在运行的沙箱并访问元数据。
running_sandboxes_paginator = Sandbox.list(
query=SandboxQuery(
state=[SandboxState.RUNNING],
),
)
running_sandboxes = running_sandboxes_paginator.next_items()
print(running_sandboxes[0].metadata)
# 输出示例：
# { userId: '123' }
sandbox.kill()