132 lines
3.7 KiB
Markdown
132 lines
3.7 KiB
Markdown
---
|
||
title: Role
|
||
description: 表示带有自定义权限设定的用户组。
|
||
menu:
|
||
docs:
|
||
parent: entities
|
||
aliases: [
|
||
"/entities/role",
|
||
"/entities/Role",
|
||
"/api/entities/role",
|
||
"/api/entities/Role",
|
||
]
|
||
---
|
||
|
||
## 示例
|
||
|
||
```json
|
||
{
|
||
"id": "3",
|
||
"name": "Owner",
|
||
"color": "#ff3838",
|
||
"permissions": "1048575",
|
||
"highlighted": true
|
||
}
|
||
```
|
||
|
||
## 属性
|
||
|
||
### `id` {#id}
|
||
|
||
**描述:** 数据库中用户组的 ID。\
|
||
**类型:** 字符串\
|
||
**版本历史:**\
|
||
4.0.0 - 添加
|
||
|
||
### `name` {#name}
|
||
|
||
**描述:** 用户组的名称。\
|
||
**类型:** 字符串\
|
||
**版本历史:**\
|
||
4.0.0 - 添加
|
||
|
||
### `color` {#color}
|
||
|
||
**描述:** 分配给此用户组的十六进制代码。如果未分配十六进制代码，则字符串将为空。\
|
||
**类型:** 字符串\
|
||
**版本历史:**\
|
||
4.0.0 - 添加
|
||
|
||
### `permissions` {#permissions}
|
||
|
||
**描述:** 一个位掩码，表示授予该用户组的所有权限的总和。\
|
||
**类型:** 字符串\
|
||
**版本历史:**\
|
||
4.0.0 - 添加
|
||
|
||
### `highlighted` {#highlighted}
|
||
|
||
**描述:** 是否在用户账户页上公开显示该用户组徽章。\
|
||
**类型:** 布尔值\
|
||
**版本历史:**\
|
||
4.0.0 - 添加
|
||
|
||
## 权限标志
|
||
|
||
要确定特定用户组可用的权限，请将 `permissions` 属性转换为二进制，然后从最低有效位开始进行比较。为了方便起见（并防止术语变得太长），权限将在下面使用十六进制值表示。
|
||
|
||
0x1
|
||
: **Administrator（管理员）**。拥有此权限的用户将绕过所有权限。
|
||
|
||
0x2
|
||
: **Devops（运维）**。允许用户访问 Sidekiq 和 PgHero 仪表板。
|
||
|
||
0x4
|
||
: **View Audit Log（查看审计日志）**。允许用户查看管理员操作的历史记录。
|
||
|
||
0x8
|
||
: **View Dashboard（查看仪表板）**。允许用户访问仪表板和各种指标。
|
||
|
||
0x10
|
||
: **Manage Reports（管理举报）**。允许用户审查举报并对其执行管理操作。
|
||
|
||
0x20
|
||
: **Manage Federation（管理联合）**。允许用户阻止或允许与其他域的联合，并控制可交付性。
|
||
|
||
0x40
|
||
: **Manage Settings（管理设置）**。允许用户更改站点设置。
|
||
|
||
0x80
|
||
: **Manage Blocks（管理屏蔽）**。允许用户屏蔽电子邮件提供商和 IP 地址。
|
||
|
||
0x100
|
||
: **Manage Taxonomies（管理热门内容）**。允许用户查看热门内容并更新话题标签设置。
|
||
|
||
0x200
|
||
: **Manage Appeals（管理申诉）**。允许用户审查针对管理操作的申诉。
|
||
|
||
0x400
|
||
: **Manage Users（管理用户）**。允许用户查看其他用户的详细信息并对其执行管理操作。
|
||
|
||
0x800
|
||
: **Manage Invites（管理邀请）**。允许用户浏览和停用邀请链接。
|
||
|
||
0x1000
|
||
: **Manage Rules（管理规则）**。允许用户更改实例规则。
|
||
|
||
0x2000
|
||
: **Manage Announcements（管理公告）**。允许用户管理实例上的公告。
|
||
|
||
0x4000
|
||
: **Manage Custom Emojis（管理自定义表情）**。允许用户管理实例上的自定义表情。
|
||
|
||
0x8000
|
||
: **Manage Webhooks（管理 Webhook）**。允许用户为管理事件设置 Webhook。
|
||
|
||
0x10000
|
||
: **Invite Users（邀请用户）**。允许用户邀请新人加入实例。
|
||
|
||
0x20000
|
||
: **Manage Roles（管理用户组）**。允许用户管理和分配权限低于其用户组权限的用户组。
|
||
|
||
0x40000
|
||
: **Manage User Access（管理用户权限）**。允许用户禁用其他用户的双因素身份验证、更改其电子邮件地址和重置其密码。
|
||
|
||
0x80000
|
||
: **Delete User Data（删除用户数据）**。允许用户立即删除其他用户的数据。
|
||
|
||
## 另请参见
|
||
|
||
{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/role_serializer.rb" caption="app/serializers/rest/role_serializer.rb" >}}
|
||
|
||
{{< translation-status-zh-cn raw_title="Role" raw_link="/entities/Role/" last_translation_time="2025-04-21" raw_commit="6addd5cf525adec1859f48c52dafcfe1f96e558a">}}
|