`mc alias set`

语法

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

EXAMPLE

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

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

如果 myminio 别名已经存在，该命令会用新的 URL、访问密钥和秘密密钥覆盖原有的别名。

SYNTAX

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

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

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

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

参数

ALIAS

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

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

在 RELEASE.2024-01-11T05-49-32Z 版本发生变更: 别名也可以是一个单个字母（ a-z 或 A-Z ）。

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

myminio
Test-1
A
a

URL

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

https://minio.example.net

ACCESSKEY

必需的

用于向S3服务进行身份验证的访问密钥。

SECRETKEY

必需的

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

--api

可选

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

S3v4 (Default)
S3v2

备注

AWS Signature V2已被AWS视为弃用 mc alias set 命令只为此选项包括S3存储桶或仍依赖Signature V2的服务。

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

--path

可选

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

auto (Default)
on
off

全局标记

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

示例

添加或更新 MinIO 部署的别名

使用 mc alias set 命令为 mc 添加一个与 S3 兼容的服务：

Example

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

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

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

Syntax

mc alias set ALIAS HOSTNAME ACCESSKEY SECRETKEY

将 ALIAS 替换为要与 MinIO 服务关联的名称。
将 HOSTNAME 替换为 MinIO 部署中任何节点的 URL。您还可以选择指定一个负载均衡器或反向代理的 URL，该负载均衡器或反向代理管理对 MinIO 部署的连接。
将 ACCESSKEY 和 ACCESSKEY 替换为 MinIO 部署上用户的凭据。

行为

S3兼容性

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

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

所需的凭据和访问控制

当使用 mc alias set 命令为与S3兼容的主机设置别名时，必须指定AWS访问密钥和相应的秘密密钥。 mc 的功能将受到与指定凭据关联的政策限制。例如，如果凭据没有对特定桶的读/写权限， mc 将无法对该桶执行读取或写入操作。

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

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

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

证书

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

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

在Linux和其他类Unix系统中，为MinIO客户端存储CA证书的目录是 ~/.mc/certs/CAs/ 。
在 Windows 系统上，MinIO (mc) 客户端的证书和 CA 证书存储在 C:\Users\[username]\mc\certs\CAs\ 路径下。

商业支持购买咨询