`mc admin user accesskey edit`

语法

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

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

EXAMPLE

以下命令会将新策略和秘钥应用到 myminio 部署上的 myuserserviceaccount 访问密钥:

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

SYNTAX

命令语法如下:

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

方括号 [] 表示可选参数。
参数在同一行表示它们是相互依赖的。
使用管道 | 运算符分隔的参数是相互排斥的。

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

参数

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 ( or µs )， ms ， s ， m ， h 。

要在 30 天后过期失效证书，请使用:

--expiry-duration 720h

与 --expiry 相互排斥。

--name: Optional
为访问密钥添加或修改可读名称。

--policy

Optional

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

新政策会覆盖之前附加的任何政策。

--secret-key: Optional
与新访问密钥相关联的密钥。覆盖先前的密钥。使用访问密钥的应用程序必须更新，以使用新的凭证继续执行操作。

Global Flags

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

示例

更改访问密钥的密钥

以下命令修改了 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-duration 的值，则不能添加 --expiry 命令。

行为规范

S3 兼容性

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

MinIO 不对其他 S3 兼容服务提供任何保证，因为它们的 S3 API 实现是未知的，因此不受支持。尽管 mc 命令可能如文档中所述工作，但任何此类使用都是您自己的风险。

商业支持购买咨询