PutBucketQuota
更新时间：2026-09-10
接口描述
本接口用于为单个 Bucket 设置容量上限及 Object 个数上限。
注意： 只有 Bucket 的 owner 且拥有 FULL_CONTROL 权限才能够进行此请求。
请求
请求结构
Http
1PUT /?quota HTTP/1.1
2Host: <BucketName>.bj.bcebos.com
3Date: <Date>
4Authorization: <Authorization_String>
5
6{
7 "maxObjectCount": <MaxObjectCount>,
8 "maxCapacityMegaBytes": <MaxCapacityMegaBytes>
9}请求头域
无特殊请求头域。
请求参数
| 名称 | 类型 | 位置 | 是否必须 | 描述 | 备注 |
|---|---|---|---|---|---|
| quota | string | Query | 是 | 设置 Bucket 配额的子资源标识。 | 请求 URI 中以 ?quota 形式指定，无需传值。 |
| maxObjectCount | int64 | Body | 是 | 单个 Bucket 最大 Object 个数限制值。 | 取值为 -1、0 或 int64 范围内的正整数；-1 或 0 表示无限制。 |
| maxCapacityMegaBytes | int64 | Body | 是 | 单个 Bucket 最大容量限制值，单位为 MB。 | 取值为 -1、0 或 int64 范围内的正整数；-1 或 0 表示无限制。 |
响应
响应头域
无特殊响应头域。
响应参数
无响应参数，响应正文为空。
示例
请求示例
Http
1PUT /?quota HTTP/1.1
2Host: <BucketName>.bj.bcebos.com
3Date: <Date>
4Authorization: <Authorization_String>
5
6{
7 "maxObjectCount": 50,
8 "maxCapacityMegaBytes": 12334424
9}响应示例
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 0A49CE4060975EAC
3Date: Wed, 12 Oct 2016 17:50:00 GMT
4Content-Length: 0
5Connection: keep-alive
6Server: BceBos评价此篇文章