L2 配置

二级节点、条件和配置。

📄️查询二层调度匹配条件列表

分页查询二层调度（L2）匹配条件，仅管理员可调用。结果按条件 ID 倒序返回。每条条件的 data 是保存的 JSON 字符串，使用时应解析为匹配规则数组。业务错误仍返回 HTTP 200：l2_cond-5 表示 page 不是数字；l2_cond-6 表示 limit 不是数字。

📄️创建二层调度匹配条件

创建可复用的二层调度（L2）匹配条件，仅管理员可调用。条件由名称、可选备注和至少一条匹配规则组成；规则值会去除空行和首尾空白并转换为小写。业务错误仍返回 HTTP 200：l2_cond-9 表示名称为空，l2_cond-10 表示名称已存在，l2_cond-11 表示缺少名称，l2_cond-12 至 l2_cond-17 分别表示规则数组、匹配项、操作符或值不符合要求。

📄️删除二层调度匹配条件

删除一个或多个二层调度（L2）匹配条件，仅管理员可调用。路径参数支持以英文逗号分隔的多个 ID；服务端会先校验全部 ID，再执行删除。正在被 L2 节点配置引用的条件不能删除。业务错误仍返回 HTTP 200：l2_cond-1 表示 ID 格式错误，l2_cond-2 表示条件不存在，l2_cond-3 表示条件仍被 L2 设置引用。

📄️获取二层调度匹配条件详情

按条件 ID 获取一条二层调度（L2）匹配条件，仅管理员可调用。不存在的条件仍返回 HTTP 200，业务错误码为 l2_cond-4。

按条件 ID 更新二层调度（L2）匹配条件，仅管理员可调用。请求体中出现的 name、des、data 字段才会参与更新；路径中的 cond_id 始终作为目标 ID，body.id 会被忽略。更新名称时不得与其他条件重名；更新规则时会同步受影响的站点配置。业务错误仍返回 HTTP 200：l2_cond-7 表示路径 ID 非数字，l2_cond-8 表示条件不存在，l2_cond-9/10 表示名称无效或重复，l2_cond-12 至 l2_cond-16 表示规则字段无效。

📄️查询二层调度配置列表

分页查询二层调度（L2）配置，仅管理员可调用。可按区域 ID 筛选，结果按配置 ID 倒序返回。业务错误仍返回 HTTP 200：l2_config-6 表示 page 不是数字；l2_config-7 表示 limit 不是数字。

📄️创建二层调度配置

创建二层调度（L2）配置，仅管理员可调用。必须指定存在的区域和唯一配置名称；未传 mode 时为 cache，未传 balance_way 时为 rr。业务错误仍返回 HTTP 200：l2_config-10 至 l2_config-13 表示区域缺失、格式不正确或不存在，l2_config-14 至 l2_config-16 表示名称为空、重复或缺失，l2_config-17/18 表示模式或负载均衡方式无效。

📄️删除二层调度配置

删除一个或多个二层调度（L2）配置，仅管理员可调用。路径参数支持以英文逗号分隔的多个 ID；服务端会先校验全部配置，再删除配置下的 L2 节点关联记录。仍被节点组或使用自定义 L2 配置的网站引用的配置不能删除。业务错误仍返回 HTTP 200：l2_config-1 表示 ID 格式错误，l2_config-2 表示配置不存在，l2_config-3 表示被节点组引用，l2_config-4 表示被网站引用。

📄️获取二层调度配置详情

按配置 ID 获取一条二层调度（L2）配置，仅管理员可调用。配置不存在时仍返回 HTTP 200，业务错误码为 l2_config-5。

📄️更新二层调度配置

按配置 ID 更新二层调度（L2）配置，仅管理员可调用。请求体中出现的字段才会参与更新，路径中的 config_id 始终作为目标 ID，body.id 会被忽略。修改 mode 或 balance_way 时，如有站点使用该配置，服务端会触发相应区域的配置同步。业务错误仍返回 HTTP 200：l2_config-8/9 表示配置 ID 无效或不存在，l2_config-10 至 l2_config-12 表示区域无效，l2_config-14/15 表示名称无效或重复，l2_config-17/18 表示枚举值无效。

📄️查询二层调度节点列表

查询指定二层调度（L2）配置下的节点，仅管理员可调用。结果按每个匹配条件组的最大排序值倒序排列。虽然服务端未显式校验 l2_config_id，但其 SQL 查询始终需要该值；调用时必须传入有效的配置 ID。业务错误仍返回 HTTP 200：l2_node-31 表示 page 不是数字，l2_node-32 表示 limit 不是数字。

📄️添加二层调度节点

向二层调度（L2）配置添加一个或多个节点，仅管理员可调用。请求体可为单个对象或对象数组；每个节点必须属于配置所在区域、类型为 L2、已启用且为根节点。节点与条件组合不得重复。创建时关联记录固定为启用状态，未传 weight 时为 1，未传 sort 时为 100。业务错误仍返回 HTTP 200：l2_node-1 表示请求不是对象或数组；l2_node-8 至 l2_node-18 表示配置或节点不符合要求；l2_node-21/22 表示条件无效；l2_node-24 表示组合重复；l2_node-25 至 l2_node-29 表示启用值、权重或排序值无效；l2_node-34 表示节点配置任务尚未完成。

📄️批量更新二层调度节点

批量更新二层调度（L2）节点关联，仅管理员可调用。请求体可为一个对象或对象数组；每个对象必须给出关联 ID。未提供的 l2_config_id、node_id、l2_cond_id、weight 会沿用当前值；修改 sort 会同时更新同一配置和条件组中节点的排序值。更新节点或配置时仍会校验节点类型、启用状态、区域及组合唯一性，并在有站点使用该配置时触发配置同步。业务错误仍返回 HTTP 200：l2_node-2/3 表示请求格式不正确，l2_node-6/7 表示关联 ID 无效或不存在，l2_node-8 至 l2_node-24 表示关联配置、节点或条件无效，l2_node-25 至 l2_node-29 表示启用值、权重或排序值无效，l2_node-33 表示节点当前已禁用。