四层转发
四层转发及其分组。
查询四层转发组列表
分页查询四层转发组。普通用户只能看到自己的转发组;管理员可使用 `uid` 仅查看指定用户的转发组。结果按组 ID 倒序返回。
新增四层转发组
创建一个四层转发组。请求体必须是单个 JSON 对象,不支持数组。组名会经过 XSS 过滤,且同一用户下不能重复;创建数量受当前用户可关联转发资源的配额限制。管理员可通过 `uid` 为指定用户创建。
删除四层转发组
删除一个或多个四层转发组。路径参数支持单个 ID 或英文逗号分隔的多个 ID。每个转发组必须存在、属于当前用户(否则需要管理员权限),并且尚未关联任何四层转发;任一组不满足条件时整个请求会回滚。
获取四层转发组详情
查询单个四层转发组的基础资料。普通用户只能查询自己创建的转发组;查询其他用户的转发组需要管理员权限。
更新四层转发组
更新指定四层转发组的名称或备注。路径中的 `group_id` 会写入请求对象,客户端传入的 `id` 无法改变更新目标。请求体必须是 JSON 对象;普通用户仅能更新自己的转发组,管理员可更新其他用户的组。
查询四层转发列表
分页查询四层转发,并可按监听端口、源站、分组、套餐、区域、线路、CNAME 和状态筛选。普通用户始终只能查看自己的转发;管理员可用 `uid` 查询指定用户。结果按转发 ID 倒序返回。
创建四层转发
创建一个或多个四层转发。请求体可以是单个对象或对象数组;每项均必须指定用户套餐、监听配置、回源端口和源站列表。未指定的协议、负载方式和 PROXY protocol 使用当前区域及用户默认配置。管理员可额外指定用户、区域、线路和 CNAME 资源。
批量更新四层转发
批量更新四层转发。请求体可为单个对象或对象数组;每个对象必须包含已有转发的 `id`,仅需传入要修改的字段。普通用户只能更新自己的转发,管理员才能修改其他用户转发或指定用户、区域、线路和 CNAME 等资源字段。
删除四层转发
删除一个或多个四层转发。路径参数可为单个 ID 或英文逗号分隔的 ID 列表。每个转发必须存在、归当前用户所有(否则需管理员权限)、已禁用,并且没有未完成的同步任务;任一项不符合条件时整次删除会回滚。
获取四层转发详情
获取指定四层转发的完整配置、套餐、线路和任务状态。普通用户仅能查看自己的转发;查询其他用户的转发需要管理员权限。监听、源站和 ACL 等配置字段按数据库原值以 JSON 字符串返回。
更新指定四层转发
更新一个四层转发。路径中的 `stream_id` 会覆盖请求体内的 ID,且请求体必须是 JSON 对象而不是数组;仅传需要修改的字段。普通用户只能更新自己的转发,管理员可修改归属用户、CNAME、区域与线路等资源字段。