`mc alias set`

语法

mc alias set 命令用于在本地 mc 配置中添加或更新别名。

示例

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

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

如果 myminio 别名已存在，该命令会使用新的 URL、access key 和 secret key 覆盖该别名。

语法

mc alias set 命令语法如下：

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

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

请先将示例复制到文本编辑器中并按需修改，再在终端 / shell 中运行命令。

参数

ALIAS

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

只能包含 ASCII 小写字母（a-z）、大写字母（A-Z）、数字（[0-9]）、连字符（-）或下划线（_）。
长度为 2 个或更多字符。
首字符必须是字母。

Changed in version RELEASE.2024-01-11T05-49-32Z: 别名也可以是单个字母（a-z 或 A-Z）。

部分有效别名示例如下：

myminio
Test-1
A
a

URL

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

https://minio.example.net

ACCESSKEY

必填

用于对 S3 服务进行身份验证的 access key。

SECRETKEY

必填

用于对 S3 服务进行身份验证的 secret key。

--api

可选

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

``S3v4``（默认）
S3v2

Note

AWS 将 AWS Signature V2 视为 deprecated。 mc alias set 保留该选项，仅用于仍依赖 Signature V2 的 S3 存储桶或服务。

除非 S3 兼容服务明确要求，否则请使用 S3v4。 MinIO server 不依赖也不要求 S3v2，且并非所有 API 操作都可在 S3v2 上使用。

--path

可选

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

``”auto”``（默认）
"on"
"off"

全局标志

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

示例

为 MinIO 部署添加或更新别名

使用 mc alias set 添加一个供 mc 使用的 S3 兼容服务：

示例

以下命令创建一个新的别名 myminio，指向位于 https://minio.example.net 的 MinIO 部署。该别名使用 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。你也可以指定用于管理 MinIO 部署连接的负载均衡器或反向代理 URL。
将 ACCESSKEY 和 SECRETKEY 替换为 MinIO 部署中某个用户的凭据。

行为

S3 兼容性

mc 命令行工具以兼容 AWS S3 API 为目标构建，并针对 MinIO 和 AWS S3 进行了测试，以验证预期的功能与行为。

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

所需凭据与访问控制

mc alias set 要求为 S3 兼容主机指定 access key 及对应的 secret key。mc 的功能受指定凭据关联策略的限制。例如，如果指定凭据对某个存储桶没有读写权限，mc 就无法对该存储桶执行读写操作。

有关 MinIO 访问控制的更多信息，请参阅 Access Management。

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

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

证书

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

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

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