资源访问错误码（187*）

段位：187001 - 187999；当前 4 个；全部 V1 暴露

通用约定（HTTP status / code=1 兜底 / 响应结构）见 README

这是一组前置校验码：在几乎所有 V1 资源读写路径（容器 / 文档 / 版本 / ACL）执行业务逻辑之前统一触达——按 id 加载资源、校验资源自身状态、校验祖先容器是否封存。命中后通常意味着请求在进入具体业务前就被拦下。

187001 ACCESS_RESOURCE_NOT_FOUND

• HTTP status：200
• 含义：资源不存在
• 典型触发条件：按 id 加载目标容器 / 文档 / 版本 / ACL 条目 / 父容器时解析失败（不存在或无权访问）
• 处理建议：核对资源标识；资源可能已被删除或不在调用方可见范围内
• 示例响应：

{ "code": 187001, "msg": "资源不存在", "data": null }

187002 ACCESS_STATE_NOT_ALLOWED

• HTTP status：200
• 含义：资源当前状态不允许此操作
• 典型触发条件：目标资源自身状态不满足操作前置（如对已归档 / 已删除资源执行仅 ACTIVE 才允许的操作），具体原因见 msg
• 处理建议：先确认资源状态满足操作要求；多数生命周期端点要求资源处于 ACTIVE
• 示例响应：

{ "code": 187002, "msg": "资源当前状态不允许此操作", "data": null }

187003 ACCESS_ANCESTOR_SEALED

• HTTP status：200
• 含义：祖先容器已封存
• 典型触发条件：目标资源的某一祖先容器处于已归档 / 回收站状态，封存了整棵子树，不允许在其下执行写操作
• 处理建议：先取消相关祖先容器的归档 / 从回收站恢复，再操作其下的资源
• 示例响应：

{ "code": 187003, "msg": "祖先容器已封存", "data": null }

187004 BATCH_ACL_PARAMS_REQUIRED

• HTTP status：200
• 含义：批量设置 ACL 缺少参数
• 典型触发条件：批量设置 ACL 时 entries 为空
• 处理建议：提供至少一条 ACL 条目
• 示例响应：

{ "code": 187004, "msg": "批量 ACL 缺少参数", "data": null }