docs-mastodon/content/zh-cn/entities/Role.md

title	description	menu	aliases
Role	表示带有自定义权限设定的用户组。	docs parent entities	/entities/role /entities/Role /api/entities/role /api/entities/Role

示例

{
	"id": "3",
	"name": "Owner",
	"color": "#ff3838",
	"permissions": "1048575",
	"highlighted": true
}

属性

id

描述: 数据库中用户组的 ID。
类型: 字符串
版本历史:
4.0.0 - 添加

name

描述: 用户组的名称。
类型: 字符串
版本历史:
4.0.0 - 添加

color

描述: 分配给此用户组的十六进制代码。如果未分配十六进制代码，则字符串将为空。
类型: 字符串
版本历史:
4.0.0 - 添加

permissions

描述: 一个位掩码，表示授予该用户组的所有权限的总和。
类型: 字符串
版本历史:
4.0.0 - 添加

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">}}