跳到主要内容
版本:2.x

租户详情

概述

租户详情页用于查看和修改单个业务租户的完整信息、控制其运行状态,并追溯它的全部变更历史。从租户管理列表点击某个租户的名称链接即可进入。

详情页主要做三件事:

  • 编辑租户信息:修改名称、描述、启用状态等字段
  • 控制生命周期:启动、停止、禁用、删除一个租户
  • 追溯变更:查看该租户从创建以来每一次字段、状态变化的完整记录

界面组织

详情页分为顶部操作栏、表单区、变更历史区三个部分。

顶部操作栏

页面右上角的操作按钮会根据租户当前状态动态变化,只展示当前可执行的合法操作:

按钮何时可见作用
启动租户处于"已停止"或"待处理"且为启用状态启动租户,状态会转为"启动中"再变为"运行中"
停止租户处于"运行中"、"启动中"或"待处理"暂停租户,所有用户立即无法登录(可恢复)
删除总是可见,但仅在"启用状态 = 禁用"时可点击永久删除租户及其全部数据(不可恢复)
取消表单有未保存修改时可用撤销当前所有未保存的修改,恢复到原始值
保存表单有未保存修改时可用提交当前修改
删除按钮的可用条件

删除按钮默认可见但置灰,只有当该租户的"启用状态"被切换为禁用并保存后,删除按钮才会变为可点击。这是一道安全闸:避免误删正在运行的业务租户。

表单区

表单区展示并可编辑租户的基本信息。

字段说明

字段是否可编辑业务含义何时使用
状态只读租户当前运行状态(运行中 / 已停止等)。通过顶部"启动 / 停止"按钮切换查看租户运行情况时关注
启用状态仅"已停止"时可改是否允许启动该租户。开关切到"禁用"并保存后,该租户无法再启动,且这是删除的前置条件永久下线前必须先禁用
名称可编辑("待处理"时不可)租户的显示名称,1-100 字符客户改名、归属调整时修改
租户ID只读租户的唯一标识,系统自动生成,创建后不可改用于在 URL 中定位租户
描述可编辑租户的用途、归属说明,最多 500 字符补充或修正租户的说明信息
访问地址只读该租户的登录入口 URL,由平台域名 + 租户ID 拼成创建后交付给该租户的实际使用者
创建时间只读该租户的创建时间审计 / 排查时参考
"启用状态"开关的小细节

启用状态开关只在租户处于"已停止"状态时可拖动——这是因为"运行中"的租户必须先停止才能禁用,不能直接禁用正在运行的业务。如果你的目标是禁用一个"运行中"的租户,请先点停止,再切换启用状态。

变更历史区

表单下方是变更历史表格,按时间倒序展示该租户的每一次修改记录:

说明
变更时间该次变更发生的时间
变更类型创建(绿)/ 更新(蓝),以彩色标签呈现
变更内容具体哪个字段从什么值改成了什么值,格式为"字段名: 旧值 → 新值"
操作人执行该次变更的平台运维账号

表格的列管理、分页等通用操作详见数据表格通用操作

生命周期管理

租户有一套完整的状态机,详情页的顶部按钮就是这套状态机的"手动开关"。理解状态流转是正确使用本页的关键:

启动租户

适用场景:租户处于"待处理"或"已停止",且启用状态为"启用",需要让其正式运行。

操作步骤

  1. 确认顶部能看到启动按钮(看不到说明当前状态不允许启动,请先检查"启用状态")
  2. 点击启动,租户状态会变为"启动中"
  3. 稍候几秒到几十秒,状态会自动刷新为"运行中"
  4. 此时该租户的用户即可正常登录使用
"启动中"状态需要等待

启动过程涉及后台初始化,"启动中"是一个中间过渡态。不需要关闭页面,租户信息会自动刷新。如果长时间停留在"启动中",可点击工具栏的刷新或重新进入详情页查看。

停止租户

适用场景:临时让一个租户停摆(如客户欠费、临时维护、疑似被入侵),后续可能恢复使用。

操作步骤

  1. 点击停止按钮
  2. 在弹出的确认框中确认(提示"停止后所有租户用户将无法登录")
  3. 确认后,租户状态变为"已停止",该租户的所有用户立即被强制下线、无法再登录
  4. 停止是可恢复的——后续在详情页点击启动即可恢复
停止的影响

停止会让该租户所有用户立即无法登录。已登录的会话也会失效。在停止前,建议先通知该租户的管理员,让其做好准备。

禁用并删除租户

适用场景:确认某租户彻底下线,需要永久清除其全部数据。

操作步骤(不可逆,请严格按顺序)

  1. 先停止租户:如果租户处于"运行中"或"启动中",先点击停止转为"已停止"
  2. 切换启用状态:在"已停止"状态下,把启用状态开关切到"禁用"
  3. 保存:点击保存提交这次启用状态变更
  4. 点击删除:保存成功后,删除按钮从置灰变为可点击。点击删除,在确认弹窗中确认
  5. 删除成功后页面自动跳回租户管理列表
删除不可恢复

删除会永久清除该租户的:所有配置项数据、用户账号、角色权限、采集配置、仪表盘等全部业务数据,且无法恢复。删除前请确认:

  • 是否需要导出备份该租户的关键数据
  • 是否已通知该租户的全部用户
  • 该租户是否真的不再需要