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
- Required
要在其上创建新存储桶的 MinIO 或其他 S3 兼容服务。
如果要在 MinIO 上创建存储桶，请指定 alias 和存储桶名称。例如：
mc mb play/mybucket
如果要在本地文件系统上创建目录，请指定该目录的完整 路径。例如：
mc mb ~/mydata/mydir
- --ignore-existing, p
- Optional
指示
mc mb在存储桶或目录已存在时不执行任何操作。
- --region
- Optional
指定创建存储桶的区域。 如果指定的
ALIAS是文件系统目录，则该选项无效。如果未指定，默认值为
us-east-1。
- --with-lock, l
- Optional
在指定存储桶上启用 对象锁定。 对象锁定要求并因此隐含启用对象版本控制。
全局标志
此命令支持 全局标志 中的任意选项。
示例
创建启用对象锁定的存储桶
使用 mc mb 在 S3 兼容主机上创建存储桶。
--with-lock 选项创建启用锁定的存储桶：
mc mb --with-lock 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 命令 可能 仍能按文档说明工作，但此类 用法需要你自行承担风险。
