`mc mb`

语法

The 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 中运行命令之前根据需要进行修改。

参数

别名

必需

要创建新存储桶的 MinIO 或其他兼容 S3 的服务。

要在 MinIO 上创建存储桶，请指定别名和存储桶的名称。例如

mc mb play/mybucket

要在本地文件系统上创建目录，请指定该目录的完整路径。例如

mc mb ~/mydata/mydir

--ignore-existing, p: 可选
指示 mc mb 如果存储桶或目录已存在则不执行任何操作。

--region

可选

要在其中创建指定存储桶的区域。如果指定的 别名 是文件系统目录，则无效。

如果未指定，则默认值为 us-east-1。

--with-lock, l: 可选
在指定的存储桶上启用对象锁定。对象锁定需要启用对象版本控制，因此意味着启用对象版本控制。

重要

您只能在创建存储桶时启用对象锁定。没有启用对象锁定的存储桶不能使用存储桶生命周期管理或存储桶对象锁定功能。

--with-versioning

可选

在新存储桶上启用对象版本控制。启用版本控制后，默认情况下，MinIO 允许每个对象最多使用 Int64 版本，即超过 9.2 千亿个版本。定义对象过期规则以删除不再需要的对象版本，例如通过版本数量或版本日期进行删除。

版本控制是存储桶复制或站点复制所必需的。版本控制并不意味着或要求对象锁定。

全局标志

此命令支持所有全局标志。

示例

创建启用了对象锁定的存储桶

使用 mc mb 在兼容 S3 的主机上创建存储桶。 --with-lock 选项创建启用了锁定的存储桶

mc mb --with-lock ALIAS/BUCKET

用 别名 替换兼容 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 命令可能按文档工作，但任何此类使用都是您自己的风险。