文档

阈值和限制

此页面反映了适用于 MinIO 的限制和阈值。

请参阅硬件软件以获取相关建议和要求。

S3 API 限制

项目

规格

最大对象大小

50 TiB

最小对象大小

0 B

每个 PUT 操作的最大对象大小

非分段上传为 5 TiB
分段上传为 50 TiB

每个上传的最大分段数

10,000

分段大小范围

5 MiB 到 5 GiB。最后一部分可以为 0 B 到 5 GiB

每个列出分段请求返回的最大分段数

10,000

每个列出对象请求返回的最大对象数

1,000

每个列出分段上传请求返回的最大分段上传数

1,000

存储桶名称的最大长度

63

对象名称的最大长度

1024

每个 / 分隔的对象名称段的最大长度

255

唯一对象的最多对象版本数

10000(可配置)

擦除码限制

项目

规格

每个集群的最大服务器数

无限制

最小服务器数

1

服务器数量为 1 时每个服务器的最小驱动器数

1(适用于 SNSD 部署,不提供额外的可靠性或可用性)

服务器数量为 2 或更多时每个服务器的最小驱动器数

1

每个服务器的最大驱动器数

无限制

读取仲裁

\(N/2\)

写入仲裁

\((N/2)+1\)

对象名称限制

文件系统和操作系统限制

MinIO 中的对象名称主要受本地操作系统和文件系统的限制。Windows 和某些其他操作系统限制具有某些特殊字符的文件系统,例如 ^*|\/&";

此列表并不详尽,可能不适用于您的操作系统和文件系统组合。

请咨询您的操作系统供应商或文件系统文档以获取您所在情况的完整列表。

MinIO 建议在生产工作负载中使用基于 XFS 文件系统的 Linux 操作系统。

冲突的对象

应用程序必须为所有对象分配不冲突的唯一键。这包括避免创建名称可能与父对象或同级对象名称冲突的对象。MinIO 在冲突位置的 LIST 操作返回空集。

例如,以下操作会创建命名空间冲突

PUT data/invoices/2024/january/vendors.csv
PUT data/invoices/2024/january <- collides with existing object prefix
PUT data/invoices/2024/january
PUT data/invoices/2024/january/vendors.csv <- collides with existing object

虽然您可以对这些对象执行 GET 或 HEAD 操作,但名称冲突会导致 LIST 操作在 /invoices/2024/january 路径返回空结果集。