mc quota set

说明

mc quota set 为存储桶分配硬配额限制,超过该限制后 MinIO 不再允许写入。

计量单位

mc quota set --size 标志接受以下不区分大小写的后缀,用于表示指定大小值的单位:

后缀单位大小
kKB(Kilobyte,1000 Bytes)
mMB(Megabyte,1000 Kilobytes)
gGB(Gigabyte,1000 Megabytes)
tTB(Terabyte,1000 Gigabytes)
ki or kibKiB(Kibibyte,1024 Bites)
mi or mibMiB(Mebibyte,1024 Kibibytes)
gi or gibGiB(Gibibyte,1024 Mebibytes)
ti or tibTiB(Tebibyte,1024 Gibibytes)

如果省略后缀,则默认使用 bytes

示例

为存储桶配置硬配额

mc quota set--size 标志配合使用,可为存储桶指定硬配额。 硬配额可防止存储桶大小增长到超出指定限制。

mc quota set TARGET/BUCKET --size LIMIT
  • TARGET 替换为已配置 MinIO 部署的 alias。 将 BUCKET 替换为要设置硬配额的存储桶名称。
  • LIMIT 替换为存储桶可增长到的最大大小(整数),并可按需附加后缀。 例如,要设置 10 Terabytes 的硬限制,请指定 10t

语法

mc quota set 的语法如下:

mc quota set TARGET --size LIMIT

mc quota set 支持以下参数:

TARGET

mc-cmd

Required

要为其创建配额的存储桶完整路径。 在路径前缀中指定 MinIO 部署的 alias。 例如:

mc quota set play/mybucket --size 10Gi

--size

mc-cmd

Required

设置存储桶存储大小的最大限制。 MinIO 服务器会拒绝任何内容将超出存储桶已配置配额的传入 PUT 请求。

例如,若硬限制为 10G,当存储桶达到 10 gigabytes 时,将无法再添加任何对象。

全局标志

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

S3 兼容性

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

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

最后修改 August 2, 2026: init commit (8338d5b)

本页部分内容改编自 MinIO 对象存储文档,© 2020–至今 MinIO, Inc.,依据 CC BY 4.0 授权,由 Silo 项目转换与维护。归属与署名

本页为非官方中文翻译。如与英文原文有出入,以英文原文为准。