# 沙箱管理错误、恢复与环境

| 操作或失败阶段 | 当前合同 |
| --- | --- |
| 列表 | 不合法整数在handler为400/ErrParamInvalid；service的窗口范围违规为400/SANDBOX_INVALID_SPEC。limit=0在service按50。窗口须offset+limit+1≤2000。 |
| 管理权限 | 403/COMPUTE_RESOURCE_SPEC_FORBIDDEN；目录/共享授权失败用503/COMPUTE_RESOURCE_SPEC_ADMIN_UNAVAILABLE，区别普通沙箱权限码与Genesis管理码。 |
| Provider不可用 | 当前未统一映射503；未专门分类可为500/SANDBOX_ERROR，不虚构稳定上游错误码。 |
| 网络 | unrestricted为400/SANDBOX_NETWORK_ALLOWLIST_UNAVAILABLE；host/ports分别有SANDBOX_EGRESS_*；保存覆盖失败可503/SANDBOX_NETWORK_STORAGE_UNAVAILABLE。 |
| 配额 | 至少一字段非null，数量0至100；非法覆盖模式或空更新为400/ErrParamInvalid。 |

## 删除成功与部分失败

成功为HTTP200/OK/msg/data:{}，删除调用在请求内先保留删除意图并推进清理，不是计算资源202异步受理。阶段包括凭据退役、计算绑定停止、远端移除、Ownership清理、绑定/预留记录删除；后续失败保留恢复意图，可能已发生部分副作用。

管理读取/列表会隐藏业务创建或删除中的资源；因此404、列表消失或远端已无资源都不足证明跨存储清理完成。恢复应核对原目标、冻结生命周期身份和持久化记录，由负责人继续原清理；不承诺重复DELETE总是200，也不靠新建替代ID恢复。实际Provider删除完成语义、跨数据库及重启恢复仍待真实环境验证。

## 网络更新

完整替换managed tools与显式egress，不修改控制面内部通道或network_mode，不把空数组写成“恢复默认”。先调用Provider更新，再保存期望覆盖；任一步出错会尝试用原策略补偿，errors.Join可同时保留原失败与补偿失败。没有跨Provider/数据库事务或全局并发版本保证。GET主要叠加保存覆盖，不能仅据GET证明远端策略回滚；恢复前要保存原列表，回查Provider实际策略与持久化状态。

## 配额更新

事务加锁读取目标配额并部分更新；显式0有效，inherit/ enabled/disabled映射响应0/1/2。降低上限不主动驱逐已有沙箱，自动临时开关与并发上限分别说明。当前UpdateQuota没有依赖Provider enabled的提前拒绝，写成功不证明运行能力可用。

没有这些接口完整管理quota GET；普通GET只投影托管current/limit和默认网络目标，无法完整备份临时上限及override。写前必须有负责人确认的完整可信原值，不能先写再把响应当原备份。恢复需确认没有并发管理员变更；无expected_version/幂等键或专用回滚合同。
