mc mb

语法

mc mb 命令在指定路径创建新的存储桶或目录。

你也可将 mc mb 用于本地文件系统，实现与 mkdir -p 命令行工具类似的效果。

• 示例
• 语法

mc mb --with-locks myminio/mydata

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

参数

ALIAS

mc-cmd

Required

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

如果要在 MinIO 上创建存储桶，请指定 alias 和存储桶名称。例如：

mc mb play/mybucket

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

mc mb ~/mydata/mydir

--ignore-existing, p

mc-cmd

Optional

指示 mc mb 在存储桶或目录已存在时不执行任何操作。

--region

mc-cmd

Optional

指定创建存储桶的区域。 如果指定的 ALIAS 是文件系统目录，则该选项无效。

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

--with-lock, l

mc-cmd

Optional

在指定存储桶上启用 对象锁定。 对象锁定要求并因此隐含启用对象版本控制。

--with-versioning

mc-cmd

Optional

在新存储桶上启用 对象版本控制。 启用版本控制后，默认情况下 MinIO 允许每个对象的版本数最多达到 Int64 最大值，即超过 9.2 quintillion。 可定义 对象过期 规则，清理不再需要的对象版本，例如按版本数量或版本日期删除。

存储桶复制 或 站点复制 需要版本控制。 版本控制不隐含也不要求对象锁定。

全局标志

此命令支持 全局标志 中的任意选项。

示例

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

使用 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 alias 上创建新的存储桶 myversionedbucket。 新存储桶为桶内所有对象启用 对象版本控制。

行为

每个部署的存储桶限制

MinIO 不限制你在单个部署上可创建的存储桶数量。 但作为通用指导，MinIO 建议每个部署的存储桶数量不超过 500,000。

非 MinIO S3 服务的存储桶限制

某些 S3 服务可能限制单个用户或账户可创建的存储桶数量。 例如，Amazon S3 将每个账户限制为 100 buckets。如果用户在目标 S3 服务上达到存储桶上限，mc mb 可能返回错误。

MinIO 对象存储部署不限制每个用户可创建的 存储桶数量。

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

MinIO 遵循 AWS S3 behavior， 要求你必须在创建存储桶时启用 对象锁定。 未启用对象锁定创建的存储桶永远无法启用对象保留或锁定。

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

S3 兼容性

mc 命令行工具以兼容 AWS S3 API 为目标构建，并针对 MinIO 和 AWS S3 进行了测试，以验证预期的功能与行为。

对于其他 S3 兼容服务，MinIO 不提供任何保证，因为这些服务的 S3 API 实现未知， 因此不在支持范围内。虽然 mc 命令 可能 仍能按文档说明工作，但此类 用法需要你自行承担风险。