文档基于2025-10-10日社区最终版构建     
切换到英文版    进入演示系统    进入交流社区

MinIO Documentation

mc admin user accesskey edit

语法

Themc 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]
  • Brackets[]表示可选参数。

  • 共享同一行的参数是相互依赖的。

  • 使用竖线分隔的参数|操作符是互斥的。

将示例复制到文本编辑器中,根据需要修改,然后在终端/Shell中运行命令。

参数

ALIAS
必需

ThealiasMinIO 部署的。

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
可选

访问密钥的有效时长。 有效时间单位包括 "ns"、"us"(或 "µs")、"ms"、"s"、"m"、"h"。

要使凭据在30天后过期,请使用:

--expiry-duration 720h

与以下内容互斥--expiry.

--name
可选

添加或修改访问密钥的可读名称。

--policy
可选

通往一个政策文件附加到新访问密钥的策略,最大大小为2048个字符。 附加策略不能授予对父用户策略未明确允许的任何操作或资源的访问权限。

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

--secret-key
可选

与新的访问密钥关联的密钥。 将覆盖之前的密钥。 使用访问密钥的应用程序必须更新为使用新的凭据以继续执行操作。

全局标志

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

示例

更改访问密钥的密钥

以下命令修改访问密钥的密钥myuseraccesskeymyminio部署。

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

更改访问密钥的有效期

以下命令更改访问密钥的过期时间值myuseraccesskeymyminio部署。

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

The--expiry-duration如果访问密钥已设置值,则无法添加--expiry.

行为

S3 Compatibility

Themc命令行工具专为兼容 AWS S3 API 而构建,并已通过 MinIO 和 AWS S3 测试,确保功能与行为符合预期。

MinIO 不提供对其他 S3 兼容服务的保证,因为它们的 S3 API 实现方式未知,因此不受支持。尽管mc命令可能按文档所述工作,任何此类使用风险自负。