# 权限矩阵

每个权限点、哪些内置角色持有它、它守着哪个菜单或 API。

最后校对于 2026-10-10

权限点是夜莺权限模型的**第一层**。第二层是业务组成员关系，两层是 AND 关系：

```
能改这条告警规则  =  角色里有「改告警规则」这个权限点

                   且

                   我所在的某个团队，对这条规则所属的业务组有读写权
```

模型本身见[认证与权限模型](https://n9e.github.io/zh/docs/concepts/auth-rbac.md)，这页只是查表用的清单。

## 三个内置角色[​](#三个内置角色 "三个内置角色的直接链接")

| 角色       | 覆盖范围                                                     |
| ---------- | ------------------------------------------------------------ |
| `Admin`    | 跳过权限校验，所有权限点都视为持有，也不受业务组成员关系限制 |
| `Standard` | 日常使用者。持有绝大多数权限点                               |
| `Guest`    | 只读旁观者。只有查询类的十几个权限点                         |

自定义角色在 **人员组织 → 角色管理** 里建，勾选需要的权限点即可。

一个用户可以同时持有多个角色，权限取并集。

## 清单[​](#清单 "清单的直接链接")

带「只用于菜单可见性」的权限点不守任何接口——它只决定侧栏里那一项显不显示， 后端不会因为缺它而拒绝请求。真正的门禁是那些列了接口的。

共 **96 个权限点**。`Admin` 角色不在这张表里——它在代码里直接跳过权限校验， 所有权限点都视为持有，并且不受业务组成员关系限制。

权限点只是第一层。能不能操作某条具体数据，还要看你所在的团队对那条数据所属的 业务组有没有读写权——两层是 AND 关系。

| 权限点                        | Standard | Guest | 守着的接口                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------- | -------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `/ai-config/llm-configs`      |          |       | `GET /ai-llm-configs`<br />`GET /ai-llm-config/:id`<br />`POST /ai-llm-configs`<br />`PUT /ai-llm-config/:id`<br />`DELETE /ai-llm-config/:id`<br />`POST /ai-llm-config/test`                                                                                                                                                                                                                                                             |
| `/ai-config/skills`           |          |       | `GET /ai-skills`<br />`GET /ai-skill/:id`<br />`POST /ai-skills`<br />`PUT /ai-skill/:id`<br />`DELETE /ai-skill/:id`<br />`POST /ai-skills/import`<br />`PUT /ai-skill/:id/import`<br />`POST /ai-skills/git/install`<br />`PUT /ai-skill/:id/git/install`<br />`POST /ai-skill/:id/git/update`<br />`GET /ai-skill-file/:fileId`<br />`DELETE /ai-skill-file/:fileId`                                                                    |
| `/alert-cur-events`           | ✅       |       | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/alert-cur-events/del`       | ✅       |       | `DELETE /alert-cur-events`                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `/alert-his-events`           | ✅       |       | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/alert-mutes`                | ✅       |       | `GET /busi-groups/alert-mutes`<br />`GET /busi-group/:id/alert-mutes`<br />`GET /busi-group/:id/alert-mute/:amid`                                                                                                                                                                                                                                                                                                                          |
| `/alert-mutes/add`            | ✅       |       | `POST /busi-group/:id/alert-mutes/preview`<br />`POST /busi-group/:id/alert-mutes`<br />`POST /alert-mute-tryrun`                                                                                                                                                                                                                                                                                                                          |
| `/alert-mutes/del`            | ✅       |       | `DELETE /busi-group/:id/alert-mutes`                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/alert-mutes/put`            |          |       | `PUT /busi-group/:id/alert-mute/:amid`<br />`PUT /busi-group/:id/alert-mutes/fields`                                                                                                                                                                                                                                                                                                                                                       |
| `/alert-rules`                | ✅       |       | `GET /busi-groups/alert-rules`<br />`GET /busi-group/:id/alert-rules`<br />`GET /alert-rule/:arid`<br />`GET /alert-rule/:arid/pure`<br />`GET /alert-rule/:arid/eval-records`                                                                                                                                                                                                                                                             |
| `/alert-rules-built-in`       | ✅       |       | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/alert-rules/add`            | ✅       |       | `POST /busi-group/:id/alert-rules`<br />`POST /busi-group/:id/alert-rules/import`<br />`POST /busi-group/:id/alert-rules/clone`<br />`POST /busi-groups/alert-rules/clones`<br />`POST /busi-group/alert-rules/notify-tryrun`<br />`POST /busi-group/alert-rules/enable-tryrun`<br />`POST /busi-group/:id/alert-rule/test-fire`                                                                                                           |
| `/alert-rules/del`            | ✅       |       | `DELETE /busi-group/:id/alert-rules`                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/alert-rules/put`            | ✅       |       | `PUT /busi-group/:id/alert-rules/fields`<br />`PUT /busi-group/:id/alert-rule/:arid`<br />`PUT /busi-group/alert-rule/validate`                                                                                                                                                                                                                                                                                                            |
| `/alert-subscribes`           | ✅       |       | `GET /busi-groups/alert-subscribes`<br />`GET /busi-group/:id/alert-subscribes`<br />`GET /alert-subscribe/:sid`                                                                                                                                                                                                                                                                                                                           |
| `/alert-subscribes/add`       | ✅       |       | `POST /busi-group/:id/alert-subscribes`<br />`POST /alert-subscribe/alert-subscribes-tryrun`                                                                                                                                                                                                                                                                                                                                               |
| `/alert-subscribes/del`       | ✅       |       | `DELETE /busi-group/:id/alert-subscribes`                                                                                                                                                                                                                                                                                                                                                                                                  |
| `/alert-subscribes/put`       | ✅       |       | `PUT /busi-group/:id/alert-subscribes`                                                                                                                                                                                                                                                                                                                                                                                                     |
| `/builtin-metrics/add`        |          |       | `POST /builtin-metrics`                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `/builtin-metrics/del`        |          |       | `DELETE /builtin-metrics`                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `/builtin-metrics/put`        |          |       | `PUT /builtin-metrics`                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `/busi-groups`                | ✅       |       | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/busi-groups/add`            | ✅       |       | `POST /busi-groups`                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `/busi-groups/del`            | ✅       |       | `DELETE /busi-group/:id`                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `/busi-groups/put`            | ✅       |       | `PUT /busi-group/:id`<br />`POST /busi-group/:id/members`<br />`DELETE /busi-group/:id/members`                                                                                                                                                                                                                                                                                                                                            |
| `/components/add`             |          |       | `POST /builtin-components`<br />`POST /builtin-payloads`                                                                                                                                                                                                                                                                                                                                                                                   |
| `/components/del`             |          |       | `DELETE /builtin-components`<br />`DELETE /builtin-payloads`                                                                                                                                                                                                                                                                                                                                                                               |
| `/components/put`             |          |       | `PUT /builtin-components`<br />`PUT /builtin-payloads`                                                                                                                                                                                                                                                                                                                                                                                     |
| `/dashboards`                 | ✅       |       | `GET /busi-groups/public-boards`<br />`GET /busi-groups/boards`<br />`GET /busi-group/:id/boards`                                                                                                                                                                                                                                                                                                                                          |
| `/dashboards-built-in`        | ✅       |       | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/dashboards/add`             | ✅       |       | `POST /busi-group/:id/boards`<br />`POST /busi-group/:id/board/:bid/clone`<br />`POST /busi-groups/boards/clones`                                                                                                                                                                                                                                                                                                                          |
| `/dashboards/del`             | ✅       |       | `DELETE /boards`<br />`DELETE /dashboard-annotation/:id`                                                                                                                                                                                                                                                                                                                                                                                   |
| `/dashboards/put`             | ✅       |       | `PUT /board/:bid`<br />`PUT /board/:bid/configs`<br />`PUT /board/:bid/public`<br />`POST /dashboard-annotations`<br />`PUT /dashboard-annotation/:id`                                                                                                                                                                                                                                                                                     |
| `/embedded-dashboards`        |          |       | `GET /embedded-dashboards`                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `/embedded-dashboards/put`    |          |       | `PUT /embedded-dashboards`                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `/embedded-product/add`       |          |       | `POST /embedded-product`                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `/embedded-product/delete`    |          |       | `DELETE /embedded-product/:id`                                                                                                                                                                                                                                                                                                                                                                                                             |
| `/embedded-product/put`       |          |       | `PUT /embedded-products/weights`<br />`PUT /embedded-product/:id/hide`<br />`PUT /embedded-product/:id`                                                                                                                                                                                                                                                                                                                                    |
| `/event-pipelines`            |          |       | `GET /event-pipelines`<br />`GET /event-pipeline/:id`<br />`POST /event-pipeline-tryrun`<br />`POST /event-processor-tryrun`<br />`POST /event-pipeline/:id/trigger`<br />`POST /event-pipeline/:id/stream`<br />`GET /event-pipeline-executions`<br />`GET /event-pipeline/:id/executions`<br />`GET /event-pipeline/:id/execution/:exec_id`<br />`GET /event-pipeline-execution/:exec_id`<br />`GET /event-pipeline/:id/execution-stats` |
| `/event-pipelines/add`        |          |       | `POST /event-pipeline`                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `/event-pipelines/del`        |          |       | `DELETE /event-pipelines`                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `/event-pipelines/put`        |          |       | `PUT /event-pipeline`<br />`PUT /event-pipelines/disabled`                                                                                                                                                                                                                                                                                                                                                                                 |
| `/help/contact`               | ✅       | ✅    | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/help/migrate`               | ✅       |       | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/help/notification-settings` |          |       | `GET /notify-script`<br />`GET /notify-channel`<br />`GET /notify-config`                                                                                                                                                                                                                                                                                                                                                                  |
| `/help/servers`               | ✅       |       | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/help/version`               | ✅       | ✅    | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/job-tasks`                  | ✅       |       | `GET /busi-groups/tasks`<br />`GET /busi-group/:id/tasks`                                                                                                                                                                                                                                                                                                                                                                                  |
| `/job-tasks/add`              | ✅       |       | `POST /busi-group/:id/tasks`                                                                                                                                                                                                                                                                                                                                                                                                               |
| `/job-tasks/put`              | ✅       |       | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/job-tpls`                   | ✅       |       | `GET /busi-groups/task-tpls`<br />`GET /busi-group/:id/task-tpls`<br />`GET /busi-group/:id/task-tpl/:tid`                                                                                                                                                                                                                                                                                                                                 |
| `/job-tpls/add`               | ✅       |       | `POST /busi-group/:id/task-tpls`                                                                                                                                                                                                                                                                                                                                                                                                           |
| `/job-tpls/del`               | ✅       |       | `DELETE /busi-group/:id/task-tpl/:tid`                                                                                                                                                                                                                                                                                                                                                                                                     |
| `/job-tpls/put`               | ✅       |       | `POST /busi-group/:id/task-tpls/tags`<br />`DELETE /busi-group/:id/task-tpls/tags`<br />`PUT /busi-group/:id/task-tpl/:tid`                                                                                                                                                                                                                                                                                                                |
| `/log/explorer`               | ✅       | ✅    | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/log/index-patterns/add`     |          |       | `POST /es-index-pattern`                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `/log/index-patterns/del`     |          |       | `DELETE /es-index-pattern`                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `/log/index-patterns/put`     |          |       | `PUT /es-index-pattern`<br />`PUT /es-index-patterns/weights`                                                                                                                                                                                                                                                                                                                                                                              |
| `/metric/explorer`            | ✅       | ✅    | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/notification-channels`      |          |       | `GET /notify-channel-config/:id`<br />`GET /notify-channel-configs`<br />`POST /feishu-visible-chats/:id`<br />`POST /dingtalk-group-list/:id`                                                                                                                                                                                                                                                                                             |
| `/notification-channels/add`  |          |       | `POST /notify-channel-configs`<br />`POST /notify-channel-config/test`                                                                                                                                                                                                                                                                                                                                                                     |
| `/notification-channels/del`  |          |       | `DELETE /notify-channel-configs`                                                                                                                                                                                                                                                                                                                                                                                                           |
| `/notification-channels/put`  |          |       | `PUT /notify-channel-config/:id`                                                                                                                                                                                                                                                                                                                                                                                                           |
| `/notification-rules`         |          |       | `GET /notify-rule/:id`<br />`GET /notify-rules`<br />`POST /notify-rule/test`<br />`GET /notify-rule/custom-params`                                                                                                                                                                                                                                                                                                                        |
| `/notification-rules/add`     |          |       | `POST /notify-rules`<br />`POST /notify-rule/event-pipelines-tryrun`                                                                                                                                                                                                                                                                                                                                                                       |
| `/notification-rules/del`     |          |       | `DELETE /notify-rules`                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `/notification-rules/put`     |          |       | `PUT /notify-rule/:id`                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `/notification-templates`     |          |       | `GET /message-template/:id`                                                                                                                                                                                                                                                                                                                                                                                                                |
| `/notification-templates/add` |          |       | `POST /message-templates`                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `/notification-templates/del` |          |       | `DELETE /message-templates`                                                                                                                                                                                                                                                                                                                                                                                                                |
| `/notification-templates/put` |          |       | `PUT /message-template/:id`                                                                                                                                                                                                                                                                                                                                                                                                                |
| `/object/explorer`            | ✅       | ✅    | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/recording-rules`            | ✅       |       | `GET /busi-groups/recording-rules`<br />`GET /busi-group/:id/recording-rules`<br />`GET /recording-rule/:rrid`<br />`PUT /recording-rule/:rrid`                                                                                                                                                                                                                                                                                            |
| `/recording-rules/add`        | ✅       |       | `POST /busi-group/:id/recording-rules`                                                                                                                                                                                                                                                                                                                                                                                                     |
| `/recording-rules/del`        | ✅       |       | `DELETE /busi-group/:id/recording-rules`                                                                                                                                                                                                                                                                                                                                                                                                   |
| `/recording-rules/put`        | ✅       |       | `PUT /busi-group/:id/recording-rules/fields`                                                                                                                                                                                                                                                                                                                                                                                               |
| `/roles`                      |          |       | `GET /role/:id/ops`                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `/roles/add`                  |          |       | `POST /roles`                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `/roles/del`                  |          |       | `DELETE /role/:id`                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `/roles/put`                  |          |       | `PUT /roles`<br />`PUT /role/:id/ops`                                                                                                                                                                                                                                                                                                                                                                                                      |
| `/system/alerting-engines`    |          |       | `GET /servers`                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `/system/variable-settings`   |          |       | `GET /user-variable-configs`<br />`POST /user-variable-config`<br />`PUT /user-variable-config/:id`<br />`DELETE /user-variable-config/:id`                                                                                                                                                                                                                                                                                                |
| `/targets`                    | ✅       |       | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/targets/add`                | ✅       |       | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/targets/del`                | ✅       |       | `DELETE /targets`                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `/targets/put`                | ✅       |       | `POST /targets/tags`<br />`DELETE /targets/tags`<br />`PUT /targets/note`<br />`PUT /targets/bgids`                                                                                                                                                                                                                                                                                                                                        |
| `/trace/dependencies`         | ✅       |       | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/trace/explorer`             | ✅       | ✅    | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/user-groups`                | ✅       |       | （只用于菜单可见性）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `/user-groups/add`            | ✅       |       | `POST /user-groups`                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `/user-groups/del`            | ✅       |       | `DELETE /user-group/:id`                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `/user-groups/put`            | ✅       |       | `PUT /user-group/:id`<br />`POST /user-group/:id/members`<br />`DELETE /user-group/:id/members`                                                                                                                                                                                                                                                                                                                                            |
| `/users`                      | ✅       |       | `GET /users`                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `/users/add`                  |          |       | `POST /users`                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `/users/del`                  |          |       | `DELETE /user/:id`                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `/users/put`                  |          |       | `PUT /user/:id/profile`<br />`PUT /user/:id/password`                                                                                                                                                                                                                                                                                                                                                                                      |
