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中运行命令之前根据需要修改。
参数
- 别名
必需与 S3 兼容的服务关联的名称。别名区分大小写,必须满足以下要求
仅包含 ASCII 小写字母 (
a-z
)、大写字母 (A-Z
)、数字 ([0-9]
)、连字符 (-
) 或下划线 (_
)。长度至少为 2 个字符。
第一个字符必须是字母。
在版本 RELEASE.2024-01-11T05-49-32Z 中更改: 别名也可以是一个字母 (
a-z
或A-Z
)。一些有效的别名值示例包括
myminio
Test-1
A
a
- --api
可选
指定连接到 S3 兼容服务时使用的签名计算方法。支持以下值
S3v4
(默认)S3v2
注意
AWS 签名 V2 被 AWS 视为 已弃用。
mc alias set
仅包含此选项,用于仍然依赖签名 V2 的 S3 存储桶或服务。除非 S3 兼容服务明确要求,否则使用
S3v4
。MinIO 服务器不依赖也不需要S3v2
,而且并非所有 API 操作都可以在S3v2
上使用。
全局标志
此命令支持任何 全局标志。
示例
添加或更新 MinIO 部署的别名
使用 mc alias set
添加与 S3 兼容的服务以供 mc 使用
以下命令创建一个名为 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
将
别名
替换为与 MinIO 服务关联的名称。将
主机名
替换为 MinIO 部署中任何节点的 URL。您也可以指定用于管理与 MinIO 部署连接的负载均衡器或反向代理的 URL。将
访问密钥
和密钥
替换为 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 客户端会自动将证书颁发机构添加到
~/.mc/certs/CAs/
在 Linux 和其他类 Unix 系统上。C:\Users\[username]\mc\certs\CAs\
在 Windows 系统上。