更新看板图表完整顺序¶
PATCH /data-dashboards/{dashboard_id}/chart-order,工作区由单个非空X-Workspace-ID确定。请求仅需chart_ids数组,但handler为普通单次JSON解码,不像下钻一样拒绝未知字段/第二个JSON值;不要混写严格程度。
请求参数¶
{"chart_ids":["chart-b","chart-a"]}
字段 |
类型 |
约束 |
|---|---|---|
chart_ids |
array(字符串数组) |
必须显式提供,非null;完整非deleted图表ID排列,非部分移动列表 |
service检查每个ID非空、无首尾空白;DAO在同租户事务内锁active看板和全部非deleted图表,要求数量一致、无重复、无外来ID。pending或deleting图表拒绝排序并映射409/ErrDataDashboardOperationActive。每张图表原layout_config字段保留,只将order设为从0开始的索引;未改变布局的不更新。不是重建图表或调整SQL。
成功响应¶
成功为code/msg/data封套,data.chart_ids回显顺序。空看板显式[]可经过校验,但service复制空切片后回显可能为null;不能据回显推导删除图表。省略/null输入映射400/ErrParamInvalid,非法排列同样400,缺对象404/ErrDataDashboardNotFound,权限/依赖沿看板错误映射。响应不提供并发版本,提交前重新读详情以免使用旧排列;
Go SDK及CLI当前把显式空数组省略成{},Python保留[],详见SDK差异;没有把三者记成整个排序能力缺失。
最后更新于