`mc admin user svcacct add`

Important

此命令已被替代，并将在未来的 MinIO Client 版本中弃用。

从 MinIO Client RELEASE.2024-10-08T09-37-26Z 起，请使用 mc admin accesskey create 命令为内置 MinIO IDP 用户添加访问密钥。

如需为 AD/LDAP 用户添加访问密钥，请使用 mc idp ldap accesskey create 命令。

语法

mc admin user svcacct add 命令为现有 MinIO 或 AD/LDAP 用户添加新的访问密钥。

OpenID Connect 用户的访问密钥

要为 OpenID Connect 用户生成服务账号访问密钥，请使用 MinIO Console。

示例

以下命令会创建一个与现有 MinIO 用户关联的新访问密钥：

mc admin user svcacct add                       \
   --access-key "myuserserviceaccount"          \
   --secret-key "myuserserviceaccountpassword"  \
   --policy "/path/to/policy.json"              \
   myminio myuser

命令会返回该新账号的访问密钥和秘密密钥。

语法

命令语法如下：

mc [GLOBALFLAGS] admin user svcacct add             \
                                    [--access-key]  \
                                    [--secret-key]  \
                                    [--policy]      \
                                    [--comment]     \
                                    ALIAS           \
                                    USER

方括号 [] 表示可选参数。
同一行中的参数彼此相互依赖。
使用管道符 | 分隔的参数彼此互斥。

请先将示例复制到文本编辑器中并按需修改，再在终端 / shell 中运行命令。

参数

ALIAS: Required
MinIO 部署的 alias。

USER

Required

MinIO 要为其添加新访问密钥的用户名。

对于 MinIO 管理的用户，指定该用户的访问密钥。
对于 Active Directory/LDAP 用户，指定用户的 Distinguished Name。
对于 OpenID Connect 用户，请使用 MinIO Console 生成访问密钥。

--access-key

Optional

用作此账号访问密钥的字符串。省略时，MinIO 会自动生成一个 20 个字符的随机值。

Access Key 名称在所有用户之间必须唯一。

--comment: Optional

Changed in version RELEASE.2023-05-18T16-59-00Z: 已由 --description 和 --name 替代。

最初在 RELEASE.2023-01-28T20-29-38Z 版本中引入。

此选项已移除。请改用 --description 或 --name。

--description: Optional

New in version RELEASE.2023-05-18T16-59-00Z.

为服务账号添加描述。例如，可以说明该服务账号存在的原因。

--expiry

Optional

New in version RELEASE.2023-05-30T22-41-38Z.

为服务账号设置过期日期。该日期必须是未来时间，不能设置已经过去的过期日期。

允许的日期和时间格式：

2023-06-24
2023-06-24T10:00
2023-06-24T10:00:00
2023-06-24T10:00:00Z
2023-06-24T10:00:00-07:00

--name: Optional

New in version RELEASE.2023-05-18T16-59-00Z.

为服务账号添加一个人类可读的名称。

--policy: Optional
要附加到新访问密钥的策略文档路径，最大大小为 2048 个字符。附加的策略不能授予父用户策略未明确允许的任何操作或资源访问权限。

--secret-key: Optional
与新账号关联的秘密密钥。省略时，MinIO 会自动生成一个 40 字符的随机值。

全局标志

此命令支持全局标志中的任意选项。

行为

S3 兼容性

mc 命令行工具以兼容 AWS S3 API 为目标构建，并针对 MinIO 和 AWS S3 进行了测试，以验证预期的功能与行为。

对于其他 S3 兼容服务，MinIO 不提供任何保证，因为这些服务的 S3 API 实现未知，因此不在支持范围内。虽然 mc 命令可能仍能按文档说明工作，但此类用法需要你自行承担风险。