区域与线路
区域和线路资源管理。
获取线路列表
分页查询线路,仅管理员可调用。可按节点、线路组、线路标识、启用状态及节点名称/IP 筛选,结果按排序值和线路 ID 倒序返回。业务错误仍返回 HTTP 200:line-30/31 表示 page 或 limit 不是数字,line-32/33 表示节点或线路组 ID 不是数字,line-45 表示 enable 不是 0 或 1。
新增线路
创建一条或多条线路,仅管理员可调用。请求体可为单个对象或对象数组;每条线路必须关联存在的线路组、L1 节点及该节点的主/子 IP,且线路组、IP 和线路标识组合不得重复。创建后会按是否备用线路创建 DNS 同步任务,并可能触发关联站点和四层转发的配置同步。业务错误仍返回 HTTP 200:line-53 表示请求不是对象或数组,line-8 至 line-23、line-39 至 line-47 表示必填关联、线路信息或重复校验失败,line-52 表示节点配置任务尚未完成,line-54/55 表示启用或备用值无效,line-60 表示间隔切换的线路组不能设置主线路。
批量更新线路
仅管理员可调用。
删除线路
删除一个或多个线路,仅管理员可调用。路径参数支持以英文逗号分隔的线路记录 ID。删除前必须先禁用线路,且该线路关联的任务不能仍在处理中;删除 IPv6 线路可能恢复线路组、网站、四层转发和用户套餐的 IPv6 设置。业务错误仍返回 HTTP 200:line-1 表示 ID 格式错误,line-2 表示线路不存在,line-56 表示线路仍启用,line-57 表示关联任务仍在处理中。
获取线路详情
按线路记录 ID 获取一条线路详情,仅管理员可调用。线路不存在时仍返回 HTTP 200,业务错误码为 line-29。
更新指定线路
仅管理员可调用。
获取区域列表
分页查询区域配置,可按区域名称或区域 ID 搜索。默认第 1 页、每页 10 条;`limit=0` 时不分页。结果按 `sort` 降序、ID 降序排列;响应中的 `count` 为筛选后的区域总数。业务参数错误仍返回 HTTP 200,请依据 `code` 判断结果。
新增区域
创建区域。区域名称为必填且必须唯一;未传 `l2_check_port` 时使用 80,未传 `sort` 时使用 100。业务校验失败仍返回 HTTP 200,请依据响应中的 `code` 和 `msg` 判断结果。
删除区域
删除一个或多个区域。区域 ID 可使用英文逗号分隔批量传入。只有不包含节点、线路组、网站或四层转发的区域才允许删除;否则返回相应业务错误。业务校验失败仍返回 HTTP 200,请依据响应中的 `code` 和 `msg` 判断结果。
获取区域详情
根据区域 ID 获取区域完整配置。区域不存在时返回业务错误 `region-4`;业务错误仍使用 HTTP 200,请依据响应中的 `code` 和 `msg` 判断结果。
更新区域
更新指定区域。请求体必须为非空 JSON 对象;路径中的 `region_id` 决定更新目标,不需要也不能在请求体中传入 `id`。所有可更新字段均可选,未传字段保持原值。区域名称必须唯一,端口必须是有效端口,排序值必须为数字。业务校验失败仍返回 HTTP 200,请依据响应中的 `code` 和 `msg` 判断结果。