`mc admin user accesskey edit`

语法

命令 mc admin accesskey edit 用于修改与指定用户关联的访问密钥的配置。

该命令要求访问密钥的至少一个属性发生改变。否则，命令将退出并显示错误消息。

示例

以下命令将新的策略和密钥应用于 myuserserviceaccount 访问密钥，该密钥位于 myminio 部署中。

mc admin accesskey edit                                             \
                   myminio myuserserviceaccount                     \
                   --secret-key "myuserserviceaccountnewsecretkey"  \
                   --policy "/path/to/new/policy.json"

语法

该命令具有以下语法。

mc [GLOBALFLAGS] admin accesskey edit                      \
                                 ALIAS                     \
                                 ACCESSKEY                 \
                                 [--description string]    \
                                 [--expiry-duration value] \
                                 [--expiry value]          \
                                 [--name string]           \
                                 [--policy path]           \
                                 [--secret-key string]

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

将示例复制到文本编辑器中，并在终端/shell 中运行命令之前根据需要进行修改。

参数

ALIAS: 必需
MinIO 部署的 alias。

ACCESSKEY: 必需
要修改的访问密钥。

--description: 可选
添加或修改访问密钥的描述。例如，您可能指定访问密钥存在的理由。

--expiry

可选

设置或修改访问密钥的过期日期。日期必须在未来，您不能设置已经过期的日期。

允许的日期和时间格式

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

与 --expiry-duration 互斥。

--expiry-duration

可选

访问密钥有效的时间长度。

例如，30d，24h 或类似。要使凭据在 30 天后过期，请使用

--expiry-duration 30d

与 --expiry 互斥。

--name: 可选
添加或修改访问密钥的人类可读名称。

--policy

可选

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

新策略将覆盖任何先前附加的策略。

--secret-key: 可选
要与新访问密钥关联的密钥。将覆盖先前的密钥。使用访问密钥的应用程序必须更新以使用新的凭据才能继续执行操作。

全局标志

该命令支持任何全局标志。

示例

更改访问密钥的密钥

以下命令修改 myminio 部署中访问密钥 myuseraccesskey 的密钥。

mc admin accesskey edit myminio/ myuseraccesskey --secret-key 'new-secret-key-change-me'

更改访问密钥的过期时间

以下命令更改 myminio 部署中访问密钥 myuseraccesskey 的过期值。

mc admin accesskey edit myminio/ myuseraccesskey --expiry-duration 24h

如果访问密钥已经为 --expiry 设置了值，则无法添加 --expiry-duration。

行为

S3 兼容性

命令行工具 mc 是为了与 AWS S3 API 兼容而构建的，并且已通过 MinIO 和 AWS S3 测试，以确保预期功能和行为。

MinIO 不保证其他兼容 S3 的服务，因为它们的 S3 API 实现未知，因此不受支持。虽然 mc 命令可能按文档记录的方式工作，但任何此类使用都由您自行承担风险。