节点管理
节点和节点分组管理。
查询节点组列表
分页查询节点组及其关联区域、二层配置和使用数量，仅管理员可调用。结果按节点组 `sort` 降序、ID 降序排列；可按区域、包含指定节点的节点组或名称/CNAME 模糊搜索筛选。传 `limit=0` 时不分页。
创建节点组
创建节点组，仅管理员可调用。必须指定区域和名称；未传 `cname_hostname`、`v4_cname_hostname` 时服务端自动生成两个不同的主机名。可选关联二层配置，但该配置必须存在、属于同一区域且已绑定节点。
删除节点组
删除一个或多个节点组，仅管理员可调用。路径参数可使用英文逗号分隔多个 ID；服务端会逐个校验并删除关联线路记录。任何节点组仍被套餐、用户套餐、网站或四层转发作为主/备用节点组引用时，整次操作会失败并回滚。
获取节点组详情
获取指定节点组的原始配置记录，仅管理员可调用。该接口返回节点组表字段，不包含列表接口中的节点、网站或转发统计值。
更新节点组
更新指定节点组的配置，仅管理员可调用。路径中的 `group_id` 会覆盖请求体中的同名 ID，因此请求体不需要也不应传 `id`。所有业务字段均可按需更新；空对象也会更新记录的更新时间。更新二层配置时仍要求配置存在、区域一致且已绑定节点。
查询节点列表
分页查询主节点及其运行、配置任务状态，仅管理员可调用。默认只返回主节点（`pid=0`）；传 `sub-ip=1` 时，会在每个主节点后追加其子 IP 记录。结果按 `sort` 降序、节点 ID 降序排列；传 `limit=0` 时不分页。
创建节点
创建主节点或子 IP 节点，仅管理员可调用。请求可为单个对象或对象数组。创建主节点（`pid=0` 或省略）必须提供已连接待初始化节点的 `pending_node_id`，服务端从待初始化记录取得 IP、SID 与 UUID，禁止提交 `ip`；创建子 IP（`pid` 为已有主节点 ID）必须直接提供 `ip`。
批量更新节点
批量更新已有节点，仅管理员可调用。请求体必须为非空数组，每一项必须带现有节点 `id`；不读取查询参数。每项仅更新提供的字段，并复用节点创建时的 IP、区域、健康检查、带宽、流量限制、启停等校验规则。
删除节点
删除一个或多个已禁用的节点。路径中的节点 ID 可使用英文逗号批量传入。删除主节点前必须先删除其全部子 IP；关联线路存在未完成任务时也不能删除。传入 `action=to-pending` 时，会先将节点信息移入待初始化节点列表，再删除原节点。业务校验失败时仍返回 HTTP 200，请依据响应中的 `code` 和 `msg` 判断结果。
获取节点详情
获取指定节点的原始配置记录，仅管理员可调用。该接口返回节点表字段，不包含列表接口额外计算的节点组数量、子 IP 总数和配置任务综合状态。
更新节点
更新指定主节点的配置。请求体必须为 JSON 对象；未提供的可选字段保持原值。节点名称、IP、区域、健康检查、带宽限制和流量限制等字段将按当前配置规则校验。业务校验失败时仍返回 HTTP 200，请依据响应中的 `code` 和 `msg` 判断结果。