`mc admin user accesskey edit`

语法

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

该命令要求访问密钥至少有一个属性发生变更。否则，命令会报错退出。

示例

以下命令为 myminio 部署上的 myuserserviceaccount 访问密钥应用新的策略和 secret key：

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: Required
MinIO 部署的 alias。

ACCESSKEY: Required
要修改的访问密钥。

--description: Optional
为访问密钥添加或修改描述。例如，可用于说明该访问密钥的用途。

--expiry

Optional

设置或修改访问密钥的过期日期。日期必须为未来时间，不能设置已过去的过期日期。

允许的日期和时间格式：

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

Optional

访问密钥保持有效的时长。有效时间单位为 “ns”、”us”（或 “µs”）、”ms”、”s”、”m”、”h”。

若要让凭证在 30 天后过期，请使用：

--expiry-duration 720h

与 --expiry 互斥。

--name: Optional
为访问密钥添加或修改一个便于识别的名称。

--policy

Optional

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

新策略会覆盖此前附加的任何策略。

--secret-key: Optional
要与新访问密钥关联的 secret key。会覆盖先前的 secret key。使用该访问密钥的应用必须更新为新凭证，才能继续执行操作。

全局标志

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

示例

修改访问密钥的 secret key

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

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 进行了测试，以验证预期的功能与行为。

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