mc alias set
语法
mc alias set 命令向本地 mc 配置中添加或更新一个别名。
以下命令为一个运行在 URL https://myminio.example.net 上的 MinIO 部署 myminio 添加一个别名。mc 使用指定的用户名和密码向 MinIO 部署进行身份验证。
mc alias set myminio https://myminio.example.net minioadminuser minioadminpassword
如果 myminio 别名已存在，该命令将使用新的 URL、访问密钥和私有密钥覆盖该别名。
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 个或更多字符。
第一个字符必须是字母。
版本 RELEASE.2024-01-11T05-49-32Z 中有变化：别名也可以是单个字母（
a-z或A-Z）。一些有效别名的示例包括：
myminioTest-1Aa
- --api
可选
指定连接到 S3 兼容服务时使用的签名计算方法。支持以下值：
S3v4(默认)S3v2
注意
AWS 签名版本 2 已被 AWS 弃用。
mc alias set包含此选项仅为仍依赖签名版本 2 的 S3 存储桶或服务提供支持。除非 S3 兼容服务明确要求，否则请使用
S3v4。MinIO 服务器不依赖也不需要S3v2，并且并非所有 API 操作都在S3v2上可用。
全局标志
该命令支持任何全局标志。
示例
为 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 上测试，以确保其预期的功能和行为。
MinIO 不对其他 S3 兼容服务提供任何保证，因为它们的 S3 API 实现是未知的，因此不受支持。虽然 mc 命令可能会按文档所述工作，但任何此类使用均由您自担风险。
所需的凭证和访问控制
mc alias set 要求为 S3 兼容主机指定访问密钥和相应的私有密钥。mc 的功能受限于与指定凭证关联的策略。例如，如果指定的凭证对特定存储桶没有读/写权限，mc 将无法对该存储桶执行读或写操作。
有关 MinIO 访问控制的更多信息，请参阅访问管理。
有关 S3 访问控制的更完整文档，请参阅 Amazon S3 安全性。
对于所有其他 S3 兼容服务，请参阅该服务的文档。
证书
MinIO 客户端会获取对端证书，计算公钥指纹，并询问用户是否接受该部署的证书。
如果信任，MinIO 客户端会自动将证书颁发机构添加到：
在 Linux 和其他类 Unix 系统上为
~/.mc/certs/CAs/。在 Windows 系统上为
C:\Users\[username]\mc\certs\CAs\。
