文档基于2025-10-10日社区最终版构建     
切换到英文版    进入演示系统    进入交流社区

MinIO Documentation

mc mb

语法

Themc mb该命令在指定路径创建一个新的存储桶或目录。

你也可以使用mc mb针对本地文件系统进行操作以产生 类似于mkdir -p命令行工具。

以下命令创建一个新的存储桶mydatamyminioMinIO 部署。该命令创建存储桶 与对象锁定已启用.

mc mb --with-locks myminio/mydata

该命令具有以下语法:

mc [GLOBALFLAGS] mb                   \
                 [--ignore-existing]  \
                 [--region "string"]  \
                 [--with-lock]        \
                 [--with-versioning]  \
                 ALIAS
  • Brackets[]表示可选参数。

  • 共享同一行的参数是相互依赖的。

  • 使用竖线分隔的参数|操作符是互斥的。

将示例复制到文本编辑器中,根据需要修改,然后在终端/Shell中运行命令。

参数

ALIAS
必需

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

要在 MinIO 上创建一个存储桶,请指定别名以及存储桶的名称。例如:

mc mb play/mybucket

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

mc mb ~/mydata/mydir
--ignore-existing, p
可选

Directsmc mb如果存储桶或目录已存在,则不执行任何操作。

--region
可选

要在其中创建指定存储桶的区域。 如果指定了存储桶,则此设置无效。ALIAS是一个文件系统目录。

如果未指定,默认值为us-east-1.

--with-lock, l
可选

启用对象锁定在指定的存储桶上。 对象锁定需要并因此意味着启用对象版本控制。

重要

你可以在创建存储桶时启用对象锁定。 未启用对象锁定的存储桶无法使用Bucket Lifecycle Management or Bucket Object Locking功能。

--with-versioning
可选

启用对象版本控制在新存储桶上。 启用版本控制后,默认情况下MinIO允许每个对象最多保留Int64最大值的版本数量,即超过92亿亿个版本。 定义对象过期删除不再需要的对象版本的规则,例如根据版本数量或版本日期。

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

全局标志

此命令支持任何全局标志.

示例

创建支持对象锁定的存储桶

使用mc mb在 S3 兼容主机上创建一个存储桶。--with-lockoption 创建存储桶时启用锁定功能:

mc mb --with-lock ALIAS/BUCKET

在特定区域创建新存储桶

使用mc mb在 S3 兼容主机上创建一个存储桶。--region该选项可在所需区域创建存储桶。

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

上述命令创建了一个新存储桶,mynewbucketmyminiobucket within theus-west-2区域。

创建启用版本控制的新存储桶

mc mb --with-versioning myminio/myversionedbucket

上述命令创建了一个新存储桶,myversionedbucket, 在myminioalias. 新存储桶启用对象版本控制对于存储桶中的所有对象。

行为

每个部署的存储桶限制

MinIO 不限制您在部署中创建的存储桶数量。 然而,作为通用指导原则,MinIO 建议每个部署不超过 500,000 个存储桶。

非MinIO S3服务的存储桶限制

某些 S3 服务可能会限制给定用户或账户可以创建的存储桶数量。例如,Amazon S3 限制每个账户最多创建100个桶. mc mb如果用户已达到目标 S3 服务的存储桶限制,可能会返回错误。

MinIO 对象存储部署对每个用户可以创建的存储桶数量没有任何限制。

在存储桶创建时启用对象锁定

MinIO 遵循AWS S3 行为你在哪里必须启用对象锁定在创建存储桶时。未启用对象锁定的存储桶可以从不启用对象保留或锁定功能。

启用存储桶锁定不会设置任何对象锁定或保留设置。 建议将启用存储桶锁定作为标准做法。

S3 Compatibility

Themc命令行工具专为兼容 AWS S3 API 而构建,并已通过 MinIO 和 AWS S3 测试,确保功能与行为符合预期。

MinIO 不提供对其他 S3 兼容服务的保证,因为它们的 S3 API 实现方式未知,因此不受支持。尽管mc命令可能按文档所述工作,任何此类使用风险自负。