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

操作或失败阶段

当前合同

列表

不合法整数在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/幂等键或专用回滚合同。

最后更新于