沙箱元数据为附加在沙箱实例上的任意键值对信息。 适用于以下场景：
  • 将沙箱与用户会话关联。
  • 为沙箱存储自定义用户数据，如 API 密钥。
  • 将沙箱与用户 ID 关联并稍后需要重新 连进沙箱。
当您在创建沙箱时指定了元数据，可以通过如下方法列出正在运行的沙箱列表，并访问其元数据信息。 
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()

​
按元数据过滤沙箱列表

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