沙箱管理公共对象

字段取自当前模型JSON标签,内部绑定、令牌、角色、请求、载荷和预留记录均不返回。

Sandbox

字段

类型

说明

workspace

object,可省略

可选管理投影。当前Provider至少提供ID/owner_id,不保证名称或账号名。

id

string

对象标识;沙箱当前为远端资源名。

workspace_id

string

资源所属工作区;不是鉴权头中的工作区。

user_id

string

远端资源标签中的用户事实。

name

string

展示名称。

phase

string

unknown、provisioning、ready、error或deleting;不是完整IAM清理状态。

edge_agent_id

string

关联执行环境标识。

network_mode

string

当前定义limited或unrestricted;历史标签缺失可为空。本更新不切换模式。

network_tools

string(字符串数组),可省略

工具出网允许列表;为空时可省略。

egress_endpoints

object(对象数组),可省略

显式host/ports出网允许列表;为空时可省略。

spec

string

规格投影;读取历史标签可为空,不以创建枚举推断历史必填。

disk_gi

integer

磁盘GiB;远端标签缺失/不可解析时可为0,不代表可按0创建。

compute_resource_id

string,可省略

可选关联计算资源ID。

created_at

string

创建时间,RFC3339。

updated_at

string

更新时间,RFC3339;不保证可用于并发版本控制。

update_available

boolean / null

boolean或null;null表示当前镜像比较信息不足,不能当false。

SandboxAdminWorkspace

字段

类型

说明

id

string

对象标识;沙箱当前为远端资源名。

name

string,可省略

可选工作区名称;当前Provider不补此信息。

owner_id

string,可省略

工作区所有者投影,当前来自远端user标签;可省略。

account_name

string,可省略

可选账号名称;当前OpenShell适配不补此信息。

SandboxEgressEndpoint

字段

类型

说明

host

string

小写主机名,无scheme/端口/路径,不接受IP或localhost。

ports

integer(整数数组)

1至65535的端口数组。

SandboxQuota

字段

类型

说明

workspace_id

string

资源所属工作区;不是鉴权头中的工作区。

max_managed_count

integer

托管沙箱上限,0至100;0可持久化,不立即删除已有资源。

max_ephemeral_count

integer

临时沙箱独立上限,0至100;不是托管沙箱上限。

auto_ephemeral_override

integer

数字0继承部署默认,1启用,2停用;请求使用字符串auto_ephemeral。

updated_by

string

最近更新主体。

updated_at

string

更新时间,RFC3339;不保证可用于并发版本控制。

SandboxAdminListResult

字段

类型

说明

items

object(对象数组)

当前页托管沙箱数组,不包括临时/池资源。

limit

integer

本页上限;无total字段。

offset

integer

在过滤后的匹配集合中偏移。

has_more

string

可能还有结果;扫描达到预算时也可能为true,不保证可继续无界翻页。

投影与恢复边界

管理Provider给workspace当前只填id/owner_id;name/account_name是可选字段,不编造目录补全。读取disk_gi=0可能来自无法解析的历史标签,不改变新建规格约束。update_available为null时保留未知,typed SDK的可选字段应检查presence。

托管网络覆盖与远端实际策略分开;GET应用保存的覆盖,报错后仅回读GET不足以证明远端已恢复。配额响应是完整已保存配额,普通GET quota只是current/limit/default_egress_endpoints和可选能力投影,并非管理配置备份。

最后更新于