`mc alias set`

语法

Themc alias set命令在本地添加或更新一个别名mcconfiguration.

EXAMPLE

以下命令添加一个别名对于 MinIO 部署myminio在 URL 上运行https://myminio.example.net. mc使用指定的用户名和密码对 MinIO 部署进行身份验证：

mc alias set myminio https://myminio.example.net minioadminuser minioadminpassword

如果myminio别名已存在时，该命令将使用新的URL、访问密钥和密钥覆盖该别名。

SYNTAX

Themc alias set命令具有以下语法：

mc [GLOBALFLAGS] alias set \
                 [--api "string"]                           \
                 [--path "string"]                          \
                 ALIAS                                      \
                 URL                                        \
                 ACCESSKEY                                  \
                 SECRETKEY

Brackets[]表示可选参数。
共享同一行的参数是相互依赖的。
使用竖线分隔的参数|操作符是互斥的。

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

参数

ALIAS

必需要关联到 S3 兼容服务的名称。别名区分大小写，且必须满足以下要求：

仅包含ASCII小写字母 (a-z), 大写字母 (A-Z), 数字 ([0-9]), 连字符 (-)、或下划线（_).
2个或更多字符长度。
第一个字符必须是字母。

在版本 RELEASE.2024-01-11T05-49-32Z 中的变更：别名也可以是单个字母（a-z or A-Z).

一些有效的别名值示例包括：

myminio
Test-1
A
a

URL

必需S3兼容服务端点的URL。例如：

https://minio.example.net

ACCESSKEY

必需

用于验证 S3 服务访问权限的访问密钥。

SECRETKEY

必需

用于验证 S3 服务身份的秘密密钥。

--api

可选

指定连接到 S3 兼容服务时使用的签名计算方法。支持以下值：

S3v4(默认)
S3v2

Note

AWS Signature V2 被视为已弃用由 AWS 提供。mc alias set仅对仍依赖签名版本2的S3存储桶或服务包含此选项。

使用S3v4除非 S3 兼容服务明确要求。 MinIO 服务器不依赖也不需要S3v2，也不是所有 API 操作都可在S3v2.

--path

可选

指定服务器使用的存储桶路径查找设置。支持以下值：

"auto"(默认)
"on"
"off"

全局标志

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

示例

添加或更新 MinIO 部署的别名

使用mc alias set添加一个S3兼容服务以用于mc:

Example

以下命令创建一个新别名myminio指向一个 MinIO 部署https://minio.example.net别名使用miniouser和miniopassword用于对部署执行操作的凭据。

mc alias set myminio https://minio.example.net miniouser miniopassword

如果myminio别名已存在，mc alias set该命令会用指定的参数覆盖该别名。

语法

mc alias set ALIAS HOSTNAME ACCESSKEY SECRETKEY

替换ALIAS要关联到 MinIO 服务的名称。
替换HOSTNAME使用 MinIO 部署中任何节点的 URL。您也可以指定负载均衡器或反向代理的 URL，用于管理到 MinIO 部署的连接。
替换ACCESSKEY和SECRETKEY具有 MinIO 部署中用户的凭据。

行为

S3 Compatibility

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

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

所需凭据和访问控制

mc alias set需要为S3兼容主机指定访问密钥和对应的密钥。mc功能受到限制基于与指定凭据关联的策略。例如，如果指定凭据对特定存储桶没有读/写访问权限，mc无法对该存储桶执行读取或写入操作。

有关 MinIO 访问控制的更多信息，请参阅访问管理.

有关 S3 访问控制的更完整文档，请参阅Amazon S3 安全.

对于所有其他 S3 兼容服务，请参考该服务的文档。

证书

MinIO Client 会获取对等证书，计算公钥指纹，并询问用户是否接受部署的证书。

如果受信任，MinIO Client 会自动将证书颁发机构添加到：

~/.mc/certs/CAs/在 Linux 和其他类 Unix 系统上。
C:\Users\[username]\mc\certs\CAs\在 Windows 系统上。