按设备更新群组绑定(updateByDataAcquisitionDeviceIdWithTalkGroups)

验证状态:已源码核验、未联调;适用基线:源码归纳 @ 2026-09-14

用途与场景

以单台记录仪为主体,按 SAVE/UPDATE/REMOVE 变更集原子地更新它与各对讲群组的绑定关系(含讲话权限)。本页是 http-put-main-service-main-api-basedata-talk-group-data-acquisition-device-updatebydataacquisitiondevicei-2b219b1a 的唯一操作正本。与群组视角编辑的差别:本操作是"反向绑定",任一可靠写失败会抛错回滚整批。

使用位置

页面/功能 角色或空间分支
设备面板保存绑定变更 前端可见性要求 talk-group-data-acquisition-device:write 或 administrator(canManageReverseBind

端点

PUT /main-service/main-api/basedata/talk-group-data-acquisition-device/updateByDataAcquisitionDeviceIdWithTalkGroups — 以单台记录仪为主体,按 SAVE/UPDATE/REMOVE 变更集原子地更新它与各对讲群组的绑定关系(含讲话权限)。

端点全量事实(参数、请求/响应字段、错误码、权限点)见清单层 basedata · talk-group-data-acquisition-device 对讲组与采集设备关联;业务语义(wire 惯例、限频、租户声明等)见基础数据业务 · talk-group-data-acquisition-device 对讲组与采集设备关联

动线与完成判据

层级 判据
业务成功 status=200 && data=true
关系生效 事务提交后由 getByDataAcquisitionDeviceId 正本 读回
设备侧生效 不由本接口判定:设备 PTT 配置刷新为异步链;已加入房间的设备是否被实时踢出/改权未核验

错误与边界

  • ApiException(relation cannot be removed/updated)适用业务拒绝
  • 校验(@NotBlank@NotEmpty、元素 null)适用请求校验;认证/权限适用认证失败/权限失败
  • 保存重复绑定(SAVE 已存在对)的行为由数据库唯一约束决定,未核验具体异常形态。

调用关系与资源清理

已知缺口

  1. DATA_ACQUISITION_DEVICE_UPDATE_BY_DATA_ACQUISITION_DEVICE_ID_WITH_TALK_GROUPS 内部消息通道的消费端未核验:绑定变更后设备是否/何时收到新 PTT 配置未闭合。
  2. 未执行真实 HTTP/数据库联调;SAVE 已存在对、并发保存的异常形态未核验。