# mc quota set

LLMS 索引： [llms.txt](/zh/llms.txt)

---

<a id="mc-quota-set"></a>

<a id="command-mc.quota.set"></a>

> [!NOTE]
> **变更: RELEASE.2022-12-13T00-23-28Z**
>
> `mc quota set` 替代了 `mc admin bucket quota --hard`。

> [!NOTE]
> **变更: RELEASE.2024-07-31T15-58-33Z**
>
> `mc quota set` 已弃用。

<a id="id2" data-td-print-local></a>

## 说明 {#description}

[`mc quota set`](#command-mc.quota.set) 为存储桶分配硬配额限制，超过该限制后 MinIO 不再允许写入。

<a id="id3" data-td-print-local></a>

### 计量单位 {#units-of-measurement}

[`mc quota set --size`](#mc.quota.set.-size) 标志接受以下 **不区分大小写** 的后缀，用于表示指定大小值的单位：

| 后缀          | 单位大小                        |
| ------------- | ------------------------------- |
| `k`           | KB（Kilobyte，1000 Bytes）      |
| `m`           | MB（Megabyte，1000 Kilobytes）  |
| `g`           | GB（Gigabyte，1000 Megabytes）  |
| `t`           | TB（Terabyte，1000 Gigabytes）  |
| `ki` or `kib` | KiB（Kibibyte，1024 Bites）     |
| `mi` or `mib` | MiB（Mebibyte，1024 Kibibytes） |
| `gi` or `gib` | GiB（Gibibyte，1024 Mebibytes） |
| `ti` or `tib` | TiB（Tebibyte，1024 Gibibytes） |

如果省略后缀，则默认使用 `bytes`。

<a id="id4" data-td-print-local></a>

## 示例 {#examples}

<a id="id5" data-td-print-local></a>

### 为存储桶配置硬配额 {#configure-a-hard-quota-on-a-bucket}

将 [`mc quota set`](#command-mc.quota.set) 与 [`--size`](#mc.quota.set.-size) 标志配合使用，可为存储桶指定硬配额。 硬配额可防止存储桶大小增长到超出指定限制。

```shell
mc quota set TARGET/BUCKET --size LIMIT
```

- 将 `TARGET` 替换为已配置 MinIO 部署的 [`alias`](/zh/reference/minio-mc/mc-alias/#command-mc.alias)。 将 `BUCKET` 替换为要设置硬配额的存储桶名称。
- 将 `LIMIT` 替换为存储桶可增长到的最大大小（整数），并可按需附加后缀。 例如，要设置 10 Terabytes 的硬限制，请指定 `10t`。

<a id="id6" data-td-print-local></a>

## 语法 {#syntax}

[`mc quota set`](#command-mc.quota.set) 的语法如下：

```shell
mc quota set TARGET --size LIMIT
```

[`mc quota set`](#command-mc.quota.set) 支持以下参数：

#### `TARGET` {#mc.quota.set.TARGET}

*mc-cmd*

*Required*

要为其创建配额的存储桶完整路径。 在路径前缀中指定 MinIO 部署的 [`alias`](/zh/reference/minio-mc/mc-alias/#command-mc.alias)。 例如：

```shell
mc quota set play/mybucket --size 10Gi
```

#### `--size` {#mc.quota.set.-size}

*mc-cmd*

*Required*

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

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

<a id="id7" data-td-print-local></a>

### 全局标志 {#global-flags}

此命令支持 [全局标志](/zh/reference/minio-mc/#minio-mc-global-options) 中的任意选项。

<a id="s3" data-td-print-local></a>

### S3 兼容性 {#s3-compatibility}

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

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