区域与线路

区域和线路资源管理。

📄️查询线路列表

分页查询线路，可按节点、节点组、线路标识、启用状态或节点名称/IP 搜索筛选。结果按 sort 降序、线路 ID 降序返回。

向节点组添加一条或多条线路。请求体可为单个对象或对象数组；创建时需提供节点组和 L1 主节点。服务端会校验线路与节点组、节点和线路标识的关联，并在需要时同步相关配置。

批量更新线路记录。请求体必须为 JSON 数组，每个元素以 id 定位目标；省略字段时保留原值。服务端会校验节点组、L1 节点、线路和备线路规则，并按需要创建同步任务。

删除一个或多个线路记录。线路必须已禁用且关联任务已完成；若删除的是节点组最后一条 IPv6 线路，服务端会关闭该节点组的 IPv4 生成标记，并重新启用该组网站、流和套餐的 IPv6。

按路径 ID 查询一条线路记录。详情接口不使用列表筛选参数，且不返回节点名称、IP 和任务状态等列表连接字段。

更新指定线路记录。路径 ID 会覆盖请求体中的 id；省略字段时保留原值。服务端会校验节点组、L1 节点、线路和备线路规则，并按需要创建同步任务。

分页查询区域配置，按 `sort` 降序、ID 降序返回。可按区域名称模糊搜索或按区域 ID 精确搜索。

创建区域并配置二层健康检查端口和排序值。兼容行为：请求体提供已存在的 `id` 时会更新该区域，但成功消息仍为“区域添加成功”。

删除一个或多个区域。路径参数可用英文逗号分隔多个区域 ID。删除前会检查该区域下是否存在节点、线路组、网站或四层转发；无依赖时会同时删除该区域作用域的配置记录。

查询指定区域的完整配置记录。该详情接口不使用列表分页和搜索参数。

更新指定区域的名称、说明、二层健康检查端口或排序值。请求体必须含至少一个可更新字段；未提供的字段保持原值。修改 `l2_check_port` 时会同步该区域的 OpenResty 配置。