阈值和限制

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

请参阅硬件和软件了解相关建议和要求。

S3 API 限制

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

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

在类 Unix-like 操作系统上，路径名为 . ， .. 或 / 的对象将返回 文件访问被拒绝 错误。

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

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 路径返回空结果集。