沙箱元数据为附加在沙箱实例上的任意键值对信息。

适用于以下场景:

  • 将沙箱与用户会话关联。
  • 为沙箱存储自定义用户数据,如 API 密钥。
  • 将沙箱与用户 ID 关联并稍后需要重新 连进沙箱

当您在创建沙箱时指定了元数据,可以通过如下方法列出正在运行的沙箱列表,并访问其元数据信息。

import { Sandbox, SandboxInfo } from '@e2b/code-interpreter'

// 创建沙箱并指定元数据。
const sandbox = await Sandbox.create({
  metadata: {
    userId: '123',
  },
})

// 列出正在运行的沙箱并访问元数据。
const runningSandboxes = await Sandbox.list()

console.log(runningSandboxes[0].metadata)

// 输出示例:
// { userId: '123' }

按元数据过滤沙箱列表

您也可以基于元数据里的键值对来过滤沙箱列表,详情参考 获取沙箱列表