mc admin group

说明

mc admin group 命令用于管理 MinIO 部署上的组。

组 是 用户 的集合。每个组都可以分配一个或多个 策略，用于明确列出允许或拒绝组成员访问的 操作和资源。对于具有相同访问模式和工作负载的用户，组提供了一种 简化的共享权限管理方式。

组与基于策略的访问控制

MinIO 使用 基于策略的访问控制 (PBAC) 对已成功在部署上 认证 的用户执行授权。每条策略都包含规则，用于规定该部署上 允许或拒绝的操作/资源。可以为一个组分配一个或多个 策略。属于该组的用户会继承该组已分配的策略。用户的 总权限集合包括其显式分配的策略，以及 通过组成员关系继承的策略。

新创建的组默认不包含任何策略。要配置组的已分配策略，请使用 mc admin policy attach 命令。

有关 MinIO 用户和组的更多信息，请参见 用户管理 和 组管理。有关 MinIO 策略的更多信息， 请参见 MinIO Policy Based Access Control。

示例

创建新组

使用 mc admin group add 在兼容 S3 的主机上创建新组：

mc admin group add ALIAS GROUPNAME MEMBER [MEMBER...]

• 将 ALIAS 替换为兼容 S3 主机的 alias。
• 将 GROUPNAME 替换为要创建的 组名。
• 将 MEMBER 替换为 S3 主机上 至少 一个 用户。多个成员可按列表方式指定： MEMBER1 MEMBER2 MEMBER3

列出可用组

使用 mc admin group ls 列出兼容 S3 主机上的所有组：

mc admin group ls ALIAS

• 将 ALIAS 替换为兼容 S3 主机的 alias。

查看组详情

使用 mc admin group info 查看兼容 S3 主机上的组详细信息：

mc admin group info ALIAS GROUPNAME

• 将 ALIAS 替换为兼容 S3 主机的 alias。
• 将 GROUPNAME 替换为 组名。

删除组

使用 mc admin group rm 从兼容 S3 主机删除组：

mc admin group rm ALIAS GROUPNAME

• 将 ALIAS 替换为兼容 S3 主机的 alias。
• 将 GROUPNAME 替换为 组名。

禁用组

使用 mc admin group disable 禁用兼容 S3 主机上的组：

mc admin group disable ALIAS GROUPNAME

• 将 ALIAS 替换为兼容 S3 主机的 alias。
• 将 GROUPNAME 替换为组名。

启用组

使用 mc admin group enable 启用兼容 S3 主机上的组：

mc admin group enable ALIAS GROUPNAME

• 将 ALIAS 替换为兼容 S3 主机的 alias。
• 将 GROUPNAME 替换为组名。

快速参考

mc admin group add TARGET GROUPNAME MEMBERS

将用户添加到 MinIO 部署上的组。如果组不存在，则创建该组。

mc admin group info TARGET GROUPNAME

返回 MinIO 部署上某个组的详细信息。

mc admin group ls TARGET

返回 MinIO 部署上所有组的列表。

mc admin group rm TARGET GROUPNAME

删除 MinIO 部署上的组。

mc admin group enable TARGET GROUPNAME

启用 MinIO 部署上的组。用户只能继承已启用组分配的 策略。

mc admin group disable TARGET GROUPNAME

禁用 MinIO 部署上的组。用户不能继承已禁用组分配的 策略。

语法

mc admin group add

mc-cmd

将现有用户添加到组中。如果组不存在，该命令会创建组。 命令语法如下：

mc admin group add TARGET GROUPNAME MEMBERS

该命令接受以下参数：

TARGET

mc-cmd

已配置 MinIO 部署的 alias，命令会在该部署上 向新建或现有组添加用户

GROUPNAME

mc-cmd

组名。如果组尚不存在，该命令会创建组。可使用 mc admin group ls 查看部署上的现有组。

组名不能包含 =``（等号）或 ,``（逗号）字符。

MEMBERS

mc-cmd

要添加到组中的用户名。

该用户必须存在于 TARGET MinIO 部署上。可使用 mc admin user ls 查看部署上的可用 用户。

mc admin group info

mc-cmd

返回目标部署上该组的详细信息，例如组内所有 用户 以及分配的 策略。命令语法如下：

mc admin group info TARGET GROUPNAME

该命令接受以下参数：

TARGET

mc-cmd

已配置 MinIO 部署的 alias，用于从该部署中 获取组信息。

GROUPNAME

mc-cmd

组名。

mc admin group ls, list

mc-cmd

列出目标 MinIO 部署上的所有组。命令语法如下：

mc admin group ls TARGET

该命令接受以下参数：

TARGET

mc-cmd

已配置 MinIO 部署的 alias，用于从该部署中 获取组列表。

mc admin group rm, remove

mc-cmd

删除目标 MinIO 部署上的组。删除组不会 删除该组中的任何成员用户。请使用 mc admin user rm 从组中移除用户。

命令语法如下：

mc admin group rm TARGET GROUPNAME

该命令接受以下参数：

TARGET

mc-cmd

已配置 MinIO 部署的 alias，命令会在该部署上 删除组。

GROUPNAME

mc-cmd

要删除的组名。

mc admin group enable

mc-cmd

启用目标 MinIO 部署上的组。用户只能从已启用组继承 策略。 组在创建时默认处于启用状态。命令语法如下：

mc admin group enable TARGET GROUPNAME

该命令接受以下参数：

TARGET

mc-cmd

已配置 MinIO 部署的 alias，命令会在该部署上 启用组。

GROUPNAME

mc-cmd

要启用的组名。

mc admin group disable

mc-cmd

禁用目标 MinIO 部署上的组。用户不能从已禁用组继承 策略。命令语法如下：

mc admin group disable TARGET GROUPNAME

该命令接受以下参数：

TARGET

mc-cmd

已配置 MinIO 部署的 alias，命令会在该部署上 禁用组。

GROUPNAME

mc-cmd

要禁用的组名。