列出沙箱（v2）

分页列出你的沙箱，可按状态筛选；官方 SDK 的 Sandbox.list 调用它。

GET /e2b/v2/sandboxes● 支持

请求参数

metadatastring可选
query: Metadata query used to filter the sandboxes (e.g. "user=abc&app=prod"). Each key and values must be URL encoded.
statearray可选
query: Filter sandboxes by one or more states
orderstring可选
默认 "desc"
query: Sort direction by sandbox start time. Defaults to desc (newest first).
取值 ascdesc
startedAfterstring可选
query: Return sandboxes started at or after this timestamp.
templatestring可选
query: Filter sandboxes by a template ID or alias.
nextTokenstring可选
query: Cursor to start the list from
limitinteger可选
默认 100
query: Maximum number of items to return per page

200

错误按 E2B 格式返回，参见错误码

Successfully returned all running sandboxes

application/json

名称	类型	说明
[].templateID	string	Identifier of the template from which is the sandbox created
[].alias	string	Alias of the template
[].sandboxID	string	Identifier of the sandbox
[].clientID	string	Identifier of the client
[].startedAt	string	Time when the sandbox was started
[].endAt	string	Time when the sandbox will expire
[].cpuCount	integer	CPU cores for the sandbox
[].memoryMB	integer	Memory for the sandbox in MiB
[].diskSizeMB	integer	Disk size for the sandbox in MiB
[].metadata	any
[].state	string	State of the sandbox
[].envdVersion	string	Version of the envd running in the sandbox
[].volumeMounts	array<object>
[].volumeMounts[].name	string	Name of the volume
[].volumeMounts[].path	string	Path of the volume