节点管理

节点和节点分组管理。

📄️查询节点组列表

分页查询节点组，并返回关联区域、L2 配置、节点数、网站数和四层转发数。可按区域、节点或名称/域名搜索筛选。需要管理员身份。

创建节点组。必须指定存在的区域和唯一的节点组名称；未传 CNAME 主机名时服务端自动生成。可选 L2 配置必须与区域一致且已绑定 L2 节点。需要管理员身份。

删除一个或多个节点组及其线路。节点组仍被套餐、用户套餐、网站或四层转发作为主节点组或备用节点组使用时，不能删除。需要管理员身份。

查询指定节点组的原始配置记录。需要管理员身份。。该接口返回当前请求范围内的业务结果；业务错误仍通过 HTTP 200 返回，并由 code 字段判断。

部分更新指定节点组。请求中未提供的字段保持原值。注意：当前服务端会校验 `region_id`，但更新流程不会将该字段写回节点组；不要依赖此接口迁移节点组区域。需要管理员身份。

分页查询主节点及其状态。可按名称、IP、节点 ID、区域、启用状态、节点类型和禁用来源筛选；`sub-ip=1` 时返回列表会在主节点后紧跟其子 IP 记录。需要管理员身份。

创建单个或多个节点。主节点必须基于已连接的待接入节点初始化；子 IP 必须指定父节点 ID 和 IP。主节点也可用 pending_node_id 与 replace_node_id 替换无子 IP 的既有主节点。需要管理员身份。

提交节点数组。数组项带 `id` 时部分更新该节点；不带 `id` 时进入创建节点流程。字段未提供时保留原值；创建项的必填条件与创建节点接口一致。需要管理员身份。

删除一个或多个节点及关联线路。节点必须先禁用；主节点或转入待接入队列的节点还必须先删除所有子 IP。`action=to-pending` 会在删除前将节点信息写入待接入节点表。需要管理员身份。

查询指定节点的原始配置与状态记录。需要管理员身份。

部分更新指定节点。目标节点由路径 ID 决定，未提供的字段保持原值。需要管理员身份。