`mc mb`

語法

mc mb 命令會在指定的路徑建立新的儲存桶或目錄。

您也可以使用 mc mb 在本機檔案系統上執行，以產生類似於 mkdir -p 命令列工具的結果。

範例

以下命令會在 myminio MinIO 部署上建立一個新的儲存桶 mydata。該命令會建立啟用物件鎖定的儲存桶。

mc mb --with-locks myminio/mydata

語法

此命令具有以下語法

mc [GLOBALFLAGS] mb                   \
                 [--ignore-existing]  \
                 [--region "string"]  \
                 [--with-lock]        \
                 [--with-versioning]  \
                 ALIAS

方括號 [] 表示可選參數。
共享一行的參數是相互依賴的。
使用管道符號 | 分隔的參數是互斥的。

將範例複製到文字編輯器，並在終端機/Shell 中執行命令之前，根據需要進行修改。

參數

ALIAS

必填

要在其上建立新儲存桶的 MinIO 或其他 S3 相容服務。

若要在 MinIO 上建立儲存桶，請指定別名和儲存桶的名稱。例如

mc mb play/mybucket

若要在本機檔案系統上建立目錄，請指定該目錄的完整路徑。例如

mc mb ~/mydata/mydir

--ignore-existing, p: 可選
如果儲存桶或目錄已存在，則指示 mc mb 不執行任何操作。

--region

可選

要在其中建立指定儲存桶的區域。如果指定的 ALIAS 是檔案系統目錄，則無效。

如果未指定，預設值為 us-east-1。

--with-lock, l: 可選
在指定的儲存桶上啟用物件鎖定。物件鎖定需要並且因此暗示啟用物件版本控制。

重要事項

您只能在建立儲存桶時啟用物件鎖定。未啟用物件鎖定而建立的儲存桶無法使用儲存桶生命週期管理或儲存桶物件鎖定功能。

--with-versioning

可選

在新儲存桶上啟用物件版本控制。啟用版本控制後，預設情況下，MinIO 允許每個物件最多有 Int64 的最大值版本，或超過 9.2 Quintillion。定義物件到期規則，以移除不再需要的物件版本，例如依版本數或版本日期。

儲存桶複寫或站點複寫需要版本控制。版本控制並不暗示或要求物件鎖定。

全域旗標

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

範例

建立具有物件鎖定的儲存桶

使用 mc mb 在與 S3 相容的主機上建立儲存桶。 --with-lock 選項會建立啟用鎖定的儲存桶

mc mb --with-lock ALIAS/BUCKET

將 ALIAS 替換為與 S3 相容的主機的別名。
將 BUCKET 替換為要建立的儲存桶。

在特定區域中建立新的儲存桶

使用 mc mb 在與 S3 相容的主機上建立儲存桶。--region 選項會在所需的區域中建立儲存桶。

mc mb --region --region=us-west-2 myminio/mynewbucket

上述命令會在 us-west-2 區域內的 myminio 儲存桶上建立一個新的儲存桶 mynewbucket。

建立已啟用版本控制的新儲存桶

mc mb --with-versioning myminio/myversionedbucket

上述命令會在 myminio 別名上建立一個新的儲存桶 myversionedbucket。新的儲存桶會為該儲存桶中的所有物件啟用物件版本控制。

行為

每個部署的儲存桶限制

MinIO 不限制您在部署中可以建立的儲存桶數量。但是，MinIO 建議每個部署的儲存桶數量不超過 500,000 個，作為一般準則。

非 MinIO S3 服務的儲存桶限制

某些 S3 服務可能會限制給定使用者或帳戶可以建立的儲存桶數量。例如，Amazon S3 將每個帳戶限制為100 個儲存桶。如果使用者已達到目標 S3 服務的儲存桶限制，則mc mb可能會傳回錯誤。

MinIO 物件儲存部署不對每個使用者可以建立的儲存桶數量設定任何限制。

在建立儲存桶時啟用物件鎖定

MinIO 遵循 AWS S3 行為，您必須在建立儲存桶時啟用物件鎖定。未啟用物件鎖定而建立的儲存桶永遠無法啟用物件保留或鎖定。

啟用儲存桶鎖定並不會設定任何物件鎖定或保留設定。考慮將啟用儲存桶鎖定作為標準做法。

S3 相容性

mc 命令列工具是為與 AWS S3 API 相容而建置的，並且已使用 MinIO 和 AWS S3 進行測試，以了解預期的功能和行為。

MinIO 不為其他與 S3 相容的服務提供任何保證，因為它們的 S3 API 實作未知，因此不受支援。雖然 mc 命令可能會如文件所述工作，但任何此類使用風險自負。