容器错误码（175*）

段位：175001 - 175999；当前 27 个；全部 V1 暴露

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

经 V1 /v1/containers/* 暴露：创建（save）、更新（update）、归档 / 取消归档、回收站 / 恢复、彻底清除（purge）、移动（move）等容器生命周期与树形层级校验。

「容器不存在」复用 元数据错误码 182009；「元数据筛选必须指定类型」复用 182014。

175001 CONTAINER_ID_REQUIRED

• HTTP status：200
• 含义：缺少 containerId
• 典型触发条件：/v1/containers/update 等端点入参缺少 containerId（null 或空字符串）
• 处理建议：提供非空的 containerId
• 示例响应：

{ "code": 175001, "msg": "containerId 不能为空", "data": null }

175002 SAVE_FOR_CREATE_ONLY

• HTTP status：200
• 含义：save 仅用于创建
• 典型触发条件：用 save 端点更新已有容器
• 处理建议：创建用 save，更新请调用 update
• 示例响应：

{ "code": 175002, "msg": "save 仅用于创建，更新请用 update", "data": null }

175003 TENANT_ROOT_TYPE_NOT_INITIALIZED

• HTTP status：200
• 含义：租户根类型未初始化
• 典型触发条件：创建容器时租户根类型尚未初始化
• 处理建议：由管理员在 Console 完成租户内容模型初始化后重试
• 示例响应：

{ "code": 175003, "msg": "租户根类型未初始化", "data": null }

175004 CONTAINER_TYPE_DEPRECATED

• HTTP status：200
• 含义：容器类型已弃用
• 典型触发条件：以 DEPRECATED 状态的容器类型创建新容器
• 处理建议：改用未弃用的容器类型；已有容器不受影响
• 示例响应：

{ "code": 175004, "msg": "容器类型已弃用，不允许创建", "data": null }

175005 CONTAINER_TYPE_DISABLED

• HTTP status：200
• 含义：容器类型已禁用
• 典型触发条件：以 DISABLED 状态的容器类型创建新容器
• 处理建议：改用 ACTIVE 状态的容器类型
• 示例响应：

{ "code": 175005, "msg": "容器类型已禁用", "data": null }

175006 CONTAINER_METADATA_VALIDATION_FAILED

• HTTP status：200
• 含义：容器元数据校验失败
• 典型触发条件：创建 / 更新容器时元数据未通过校验
• 处理建议：按容器类型的字段约束修正元数据；字段级细分校验另见 元数据错误码 182*
• 示例响应：

{ "code": 175006, "msg": "容器元数据校验失败", "data": null }

175007 CONTAINER_MOVE_USE_MOVE_ENDPOINT

• HTTP status：200
• 含义：位置变更请用 move
• 典型触发条件：在 update 里试图变更容器位置（父容器）
• 处理建议：位置变更走 /v1/containers/move，update 不接受位置变更
• 示例响应：

{ "code": 175007, "msg": "位置变更请使用 move 端点", "data": null }

175008 CONTAINER_TYPE_DEPRECATED_FOR_SWITCH

• HTTP status：200
• 含义：目标类型已弃用，不允许切换
• 典型触发条件：把容器切换到一个 DEPRECATED 状态的类型
• 处理建议：仅切换到未弃用的容器类型
• 示例响应：

{ "code": 175008, "msg": "目标容器类型已弃用，不允许切换", "data": null }

175009 CONTAINER_NOT_UNDER_PARENT

• HTTP status：200
• 含义：容器不在指定父容器下
• 典型触发条件：树形校验时目标容器并不在声明的父容器下
• 处理建议：核对父子层级关系后重试
• 示例响应：

{ "code": 175009, "msg": "容器不在指定父容器下", "data": null }

175010 SYSTEM_ROOT_NO_STATS

• HTTP status：200
• 含义：系统根容器不支持统计
• 典型触发条件：对系统根容器请求统计
• 处理建议：统计仅对普通容器有效，勿对系统根发起
• 示例响应：

{ "code": 175010, "msg": "系统根容器不支持统计", "data": null }

175011 SYSTEM_ROOT_NO_LIFECYCLE

• HTTP status：200
• 含义：系统根容器不允许生命周期操作
• 典型触发条件：对系统根容器执行归档 / 删除 / 移动等
• 处理建议：系统根不可被生命周期操作；仅操作其下的普通容器
• 示例响应：

{ "code": 175011, "msg": "系统根容器不允许此操作", "data": null }

175012 CONTAINER_NOT_ACTIVE_FOR_ARCHIVE

• HTTP status：200
• 含义：仅 ACTIVE 容器可归档
• 典型触发条件：对非 ACTIVE 容器调用归档
• 处理建议：先确认容器处于 ACTIVE 再归档
• 示例响应：

{ "code": 175012, "msg": "仅 ACTIVE 容器可归档", "data": null }

175013 CONTAINER_NOT_ARCHIVED_FOR_UNARCHIVE

• HTTP status：200
• 含义：仅 ARCHIVED 容器可取消归档
• 典型触发条件：对非归档状态容器调用取消归档
• 处理建议：仅对 ARCHIVED 容器取消归档
• 示例响应：

{ "code": 175013, "msg": "仅 ARCHIVED 容器可取消归档", "data": null }

175014 CONTAINER_ALREADY_TRASHED

• HTTP status：200
• 含义：容器已在回收站中
• 典型触发条件：对已在回收站的容器重复删除
• 处理建议：无需重复删除；找回走恢复，彻底清除走 purge
• 示例响应：

{ "code": 175014, "msg": "容器已在回收站中", "data": null }

175015 CONTAINER_HAS_CHILDREN_FOR_DELETE

• HTTP status：200
• 含义：容器下存在未删除的子容器
• 典型触发条件：删除容器时其下仍有未删除的子容器
• 处理建议：先清空 / 删除子容器，再删除该容器
• 示例响应：

{ "code": 175015, "msg": "容器下存在子容器，请先清空", "data": null }

175016 CONTAINER_HAS_DOCUMENTS_FOR_DELETE

• HTTP status：200
• 含义：容器下存在未删除的文档
• 典型触发条件：删除容器时其下仍有未删除的文档
• 处理建议：先清空 / 删除文档，再删除该容器
• 示例响应：

{ "code": 175016, "msg": "容器下存在文档，请先清空", "data": null }

175017 CONTAINER_NOT_TRASHED_FOR_RESTORE

• HTTP status：200
• 含义：容器不在回收站中，无法恢复
• 典型触发条件：对未在回收站的容器调用恢复
• 处理建议：仅对处于回收站的容器执行恢复
• 示例响应：

{ "code": 175017, "msg": "容器不在回收站中", "data": null }

175018 RESTORE_PARENT_DELETED

• HTTP status：200
• 含义：恢复失败——父容器已删除
• 典型触发条件：恢复容器时其父容器已被删除
• 处理建议：先恢复 / 重建父容器后再恢复
• 示例响应：

{ "code": 175018, "msg": "恢复失败：父容器已删除", "data": null }

175019 RESTORE_PARENT_NOT_ACTIVE

• HTTP status：200
• 含义：恢复失败——父容器状态非 ACTIVE
• 典型触发条件：恢复容器时其父容器处于归档 / 回收站等非 ACTIVE 状态
• 处理建议：先把父容器恢复到 ACTIVE 再恢复
• 示例响应：

{ "code": 175019, "msg": "恢复失败：父容器非 ACTIVE", "data": null }

175020 CONTAINER_NOT_TRASHED_FOR_PURGE

• HTTP status：200
• 含义：仅回收站中的容器可彻底清除
• 典型触发条件：对未在回收站的容器调用彻底清除
• 处理建议：彻底清除前需先将容器移入回收站
• 示例响应：

{ "code": 175020, "msg": "仅回收站中的容器可彻底清除", "data": null }

175021 MOVE_TO_SYSTEM_ROOT_FORBIDDEN

• HTTP status：200
• 含义：不允许移动到系统根下
• 典型触发条件：move 的目标父容器是系统根
• 处理建议：移动到普通容器下，不可直接挂到系统根
• 示例响应：

{ "code": 175021, "msg": "不允许移动到系统根下", "data": null }

175022 MOVE_TO_SELF_FORBIDDEN

• HTTP status：200
• 含义：不能移动到自身下
• 典型触发条件：move 的目标父容器是容器自身
• 处理建议：选择其它目标父容器
• 示例响应：

{ "code": 175022, "msg": "不能移动到自身下", "data": null }

175023 MOVE_TO_DESCENDANT_FORBIDDEN

• HTTP status：200
• 含义：不能移动到自身的子容器下
• 典型触发条件：move 的目标父容器是该容器的后代（会形成环）
• 处理建议：选择不在该容器子树内的目标父容器
• 示例响应：

{ "code": 175023, "msg": "不能移动到自身的子容器下", "data": null }

175024 MOVE_TARGET_PARENT_NOT_FOUND

• HTTP status：200
• 含义：目标父容器不存在
• 典型触发条件：move 指定的目标父容器查无对应记录
• 处理建议：核对目标父容器标识
• 示例响应：

{ "code": 175024, "msg": "目标父容器不存在", "data": null }

175025 CONTAINER_SCOPE_STRATEGY_NOT_WHITELIST

• HTTP status：200
• 含义：仅白名单策略的 Client 可设置容器范围
• 典型触发条件：在非 WHITELIST 容器作用域策略下尝试设置容器范围
• 处理建议：容器范围设置仅对 WHITELIST 策略的 Client 有效；策略由部署方在 Console 配置
• 示例响应：

{ "code": 175025, "msg": "仅白名单策略可设置容器范围", "data": null }

175028 CLIENT_TOKEN_REQUIRED

• HTTP status：200
• 含义：仅允许 API Client Token 访问
• 典型触发条件：以非 API Client Token 的身份访问仅限 Client Token 的容器端点
• 处理建议：使用 API Client 凭证换取的 token 访问该接口
• 示例响应：

{ "code": 175028, "msg": "仅允许 API Client Token 访问", "data": null }

175031 DEFAULT_CONTAINER_PROTECTED

• HTTP status：200
• 含义：默认容器受系统保护，不允许此操作
• 典型触发条件：对租户的「默认容器」执行删除、改名或移动。默认容器是上传文档未指定 containerId 时的自动归属落点，由系统自动创建并维护，受保护以确保该落点始终稳定可用
• 处理建议：默认容器不可删除 / 改名 / 移动；如需整理内容，移动默认容器内的文档到其它容器即可，默认容器本身保持原状
• 示例响应：

{ "code": 175031, "msg": "默认容器受系统保护，不允许此操作", "data": null }