# 沙箱管理公共对象

字段取自当前模型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和可选能力投影，并非管理配置备份。
