mc mb

参数

ALIAS

Required

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

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

mc mb play/mybucket

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

mc mb ~/mydata/mydir

--ignore-existing, p

Optional

如果桶或目录已经存在，mc mb 将不会执行任何操作。

--region

Optional

创建指定桶所在的区域。 如果指定的 ALIAS 是一个文件系统目录，指定区域将无效。

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

--with-lock, l

Optional

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

重要

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

--with-versioning

Optional

新桶上启用 对象版本控制。 启用版本控制, 默认情况下，MinIO 允许每个对象最多使用 Int64 版本的最大值, 或超过 9.2 万亿。 Define object expiration rules to remove versions of objects no longer needed, such as by the number of versions or the date of versions.

版本控制是 桶复制 或 站点复制 所必需的。 版本控制不暗示或要求对象锁定。

全局标记

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

创建带对象锁定的桶

使用 mc mb 在 S3 兼容的主机上创建一个桶。 --with-lock 选项创建一个带有锁定功能的桶：

mc mb --with-lock ALIAS/BUCKET

• 将 ALIAS 替换为 S3 兼容主机的 alias。

• 将 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 服务可能会限制给定用户或账户可以创建的桶的数量。 例如，亚马逊 S3 限制每个账户最多可以创建 100 个桶。如果用户在目标 S3 服 务上达到了桶的限制，mc mb 命令可能会返回一个错误。

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

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

MinIO 遵循 AWS S3 behavior ， 即在创建桶时 必须 启用 对象锁定。 存储桶创建。在没有对象锁定的情况下创建的存储桶*永远不会*启用对象 保留或锁定。

启用了桶锁定并 不 意味着设置了任何对象锁定或保留设置。 考虑将启用桶锁定作为一种标准做法。

S3兼容性

mc 命令行工具是为了与 AWS S3 API 兼容而构建的，并且已经过测试， 以确保在与 MinIO 和 AWS S3 配合使用时，功能和行为符合预期。

MinIO 不对其他 S3 兼容服务提供任何保证，因为它们的 S3 API 实现是 未知的，因此不受支持。尽管 mc 命令 可能 如文档中所 述工作，但任何此类使用都是您自己的风险。