mc alias

MinIO 客户端的 mc alias 命令是用来管理别名，如：新增别名、删除别名和列出别名列表。

使用 mc alias -h 命令查看 mc alias 帮助信息，如下：

C:\> mc alias -h
NAME:
  mc alias - set, remove and list aliases in configuration file

USAGE:
  mc alias COMMAND [COMMAND FLAGS | -h] [ARGUMENTS...]

COMMANDS:
  set, s      set a new alias to configuration file
  list, ls    list aliases in configuration file
  remove, rm  remove an alias from configuration file

FLAGS:
  --config-dir value, -C value  path to configuration folder (default: "C:\\Users\\Administrator\\mc")
  --quiet, -q                   disable progress bar display
  --no-color                    disable color theme
  --json                        enable JSON lines formatted output
  --debug                       enable debug output
  --insecure                    disable SSL certificate verification
  --help, -h                    show help

mc alias 命令支持三个子命令，分别为：

• set,s：设置一个新的别名到配置文件

• list,ls：列出配置文件中的别名列表

• remove,rm：从配置文件中删除一个别名

minio广告位

mc alias set

该命令用来添加新别名到配置文件，语法如下：

C:\> mc alias set -h
NAME:
  mc alias set - set a new alias to configuration file

USAGE:
  mc alias set ALIAS URL ACCESSKEY SECRETKEY

FLAGS:
  --path value                  bucket path lookup supported by the server. Valid options are '[auto, on, off]' (default: "auto")
  --api value                   API signature. Valid options are '[S3v4, S3v2]'
  --config-dir value, -C value  path to configuration folder (default: "C:\\Users\\Administrator\\mc")
  --quiet, -q                   disable progress bar display
  --no-color                    disable color theme
  --json                        enable JSON lines formatted output
  --debug                       enable debug output
  --insecure                    disable SSL certificate verification
  --help, -h                    show help

示例

注意：

由于我们使用 mc alias set 命令需要指定 MinIO 服务的 Access Key 和 Securet Key，因此存在安全隐患。出于安全原因：（1）暂时关闭 bash 历史记录；

（2）请暂时禁用 Windows 历史记录活动。转到“设置/隐私/活动历史记录”并单击复选框“在此设备上存储我的活动”和“将我的活动历史记录发送给 Microsoft”以取消选择和禁用历史活动。

（1）在“myminio”别名下添加 MinIO 服务。

D:\server\minio>mc alias set myminio http://localhost:9000 root mypassword
Added `myminio` successfully.

（2）在 "myminio" 别名下添加 MinIO 服务，以使用 dns 样式的桶查找。 

D:\server\minio>mc alias set myminio http://localhost:9000 root mypassword --api "s3v4" --path "off"
Added `myminio` successfully.

（3）在“mys3”别名下添加 Amazon S3 存储服务。

D:\server\minio>mc alias set mys3 https://s3.amazonaws.com \
         BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12

（4）在“mys3”别名下添加 Amazon S3 存储服务，提示输入密钥。

D:\server\minio>mc alias set mys3 https://s3.amazonaws.com --api "s3v4" --path "off"
Enter Access Key: BKIKJAA5BMMU2RHO6IBB
Enter Secret Key: V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12

（5）使用管道密钥在“mys3”别名下添加 Amazon S3 存储服务。

D:\server\minio> echo -e "BKIKJAA5BMMU2RHO6IBB\nV8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12" | \
         mc alias set mys3 https://s3.amazonaws.com --api "s3v4" --path "off"

mc alias list

该命令用来列出配置文件中的所有别名，语法如下：

C:\> mc alias list -h
NAME:
  mc alias list - list aliases in configuration file

USAGE:
  mc alias list [ALIAS]

FLAGS:
  --config-dir value, -C value  path to configuration folder (default: "C:\\Users\\Administrator\\mc")
  --quiet, -q                   disable progress bar display
  --no-color                    disable color theme
  --json                        enable JSON lines formatted output
  --debug                       enable debug output
  --insecure                    disable SSL certificate verification
  --help, -h                    show help

示例

（1）列出所有别名。

D:\server\minio>mc alias list
gcs
  URL       : https://storage.googleapis.com
  AccessKey : YOUR-ACCESS-KEY-HERE
  SecretKey : YOUR-SECRET-KEY-HERE
  API       : S3v2
  Path      : dns

local
  URL       : http://127.0.0.1:9000
  AccessKey : root
  SecretKey : mypassword
  API       : s3v4
  Path      : auto

（2）列出指定别名信息。

D:\server\minio>mc alias list s3
s3
  URL       : https://s3.amazonaws.com
  AccessKey : YOUR-ACCESS-KEY-HERE
  SecretKey : YOUR-SECRET-KEY-HERE
  API       : S3v4
  Path      : dns

mc alias remove

该命令用来从配置文件中删除指定的别名。语法如下：

C:\> mc alias remove -h
NAME:
  mc alias remove - remove an alias from configuration file

USAGE:
  mc alias remove ALIAS

FLAGS:
  --config-dir value, -C value  path to configuration folder (default: "C:\\Users\\Administrator\\mc")
  --quiet, -q                   disable progress bar display
  --no-color                    disable color theme
  --json                        enable JSON lines formatted output
  --debug                       enable debug output
  --insecure                    disable SSL certificate verification
  --help, -h                    show help

示例

（1）从配置文件中删除名为“myminio”的别名。

D:\server\minio>mc alias remove myminio
Removed `myminio` successfully.