`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)。

一些有效的別名範例包括：

myminio
Test-1
A
a

URL

必要 S3 相容服務端點的 URL。例如：

https://minio.example.net

ACCESSKEY

必要

用於驗證 S3 服務的存取金鑰。

SECRETKEY

必要

用於驗證 S3 服務的私密金鑰。

--api

選用

指定連線至 S3 相容服務時使用的簽名計算方法。支援以下值：

S3v4 (預設)
S3v2

注意

AWS 簽名 V2 已被 AWS 視為已棄用。mc alias set 僅包含此選項，適用於仍依賴簽名 V2 的 S3 儲存貯體或服務。

除非 S3 相容服務明確要求，否則請使用 S3v4。MinIO 伺服器不依賴也不需要 S3v2，而且並非所有 API 操作都適用於 S3v2。

--path

選用

指定伺服器使用的儲存貯體路徑查詢設定。支援以下值：

"auto" (預設)
"on"
"off"

全域標誌

此命令支援任何全域標誌。

範例

為 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

將 ALIAS 取代為要與 MinIO 服務建立關聯的名稱。
將 HOSTNAME 取代為 MinIO 部署中任何節點的 URL。或者，您也可以指定管理連線至 MinIO 部署的負載平衡器或反向 Proxy 的 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 用戶端會自動將憑證授權單位新增至：

~/.mc/certs/CAs/ (在 Linux 和其他類 Unix 系統上)。
C:\Users\[username]\mc\certs\CAs\ (在 Windows 系統上)。