沙箱实例列表-函数计算(FC)-阿里云帮助中心

通过控制台、E2B SDK 或 CLI 查询当前账号下的沙箱实例列表。可按状态和元数据过滤，用于监控沙箱使用情况或在多客户端场景中查找目标沙箱。

前提条件

已安装 E2B SDK（Pythonpip install e2b==2.26.0 ；TypeScript：npm i e2b@2.28.0）
已获取 E2B API Key，并通过环境变量 E2B_API_KEY 设置

通过控制台查看沙箱列表

登录函数计算控制台。
在左侧导航栏，选择云沙箱 > 沙箱实例。

在沙箱实例列表页，查看当前地域下运行中的沙箱实例。

列表默认展示运行中（Running）的沙箱，包含以下信息：

列名	说明
沙箱 ID	沙箱唯一标识，支持复制。单击可跳转到沙箱详情页
状态	沙箱运行状态。运行中的沙箱显示绿色指示器
监控	单击可查看沙箱的监控指标
沙箱模板	沙箱使用的模板名称或模板 ID
资源规格	沙箱的 CPU、内存和磁盘配置（例如 2vCPU / 2048MB / 10240MB）
创建时间	沙箱的创建时间
操作	支持查看详情和日志

（可选）使用工具栏过滤和搜索沙箱：
- 模板筛选：在模板下拉列表中选择特定模板，仅显示使用该模板创建的沙箱。选择全部模板显示所有沙箱。
- 搜索：在搜索框中按沙箱 ID 或模板 ID 搜索特定沙箱。

通过 SDK 查询沙箱列表

使用 Sandbox.list() 方法查询当前账号下的沙箱实例。

Python 示例

from e2b import Sandbox

sandboxes = Sandbox.list(
    api_key=E2B_API_KEY,
    **E2B_CONN_OPTS,
)
for sbx in sandboxes:
    print(f"{sbx.sandbox_id}  {sbx.template_id}  {sbx.started_at}")

TypeScript 示例

import { Sandbox } from 'e2b';

const sandboxes = await Sandbox.list({
  apiKey: process.env.E2B_API_KEY!,
});
for (const sbx of sandboxes) {
  console.log(`${sbx.sandboxId}  ${sbx.templateId}  ${sbx.startedAt}`);
}

带过滤的查询

可以按 metadata 过滤沙箱列表，并设置每页返回条数。

Python 示例：

from e2b import Sandbox, SandboxQuery

# 按 metadata 过滤
paginator = Sandbox.list(
    api_key=E2B_API_KEY,
    limit=20,
    query=SandboxQuery(metadata={'project': 'my-project'})
)
items = paginator.next_items()
for sbx in items:
    print(f"{sbx.sandbox_id}  {sbx.template_id}")

分页遍历

沙箱数量较多时，使用分页遍历获取完整列表。

Python 示例：

from e2b import Sandbox

paginator = Sandbox.list(api_key=E2B_API_KEY, limit=10)
while True:
    items = paginator.next_items()
    for sbx in items:
        print(f"{sbx.sandbox_id}  {sbx.started_at}")
    if not paginator.has_next:
        break

SandboxPaginator 属性：

属性/方法	类型	说明
`has_next`	bool	是否有下一页
`next_token`	string	下一页游标
`next_items()`	List	获取当前页的沙箱列表

通过 CLI 查看沙箱列表

使用 E2B CLI 的 sandbox list 命令查询沙箱列表。

# 查看运行中的沙箱
e2b sandbox list

# 以 JSON 格式输出
e2b sandbox list --format json

# 按 metadata 过滤
e2b sandbox list --metadata project=my-project --format json

CLI 参数说明：

参数	说明
`--metadata`	按 metadata 键值对过滤，格式：`key=value`
`--format`	输出格式，设为 `json` 可输出结构化数据

JSON 输出字段包括：sandboxId、templateId、state、startedAt。

注意事项

默认只返回 running 状态的沙箱。
已终止（terminated）的沙箱不会出现在列表中
可通过 metadata 参数过滤特定业务标签的沙箱，例如按项目或用户分组管理