bucket额度管理
更新时间：2026-09-23
运行以下示例前，请先参考初始化完成 BOS Client 初始化，并将示例中的 bucket_name（及其它占位符）替换为实际值。
设置 Bucket 额度管理
Python
1quota_conf = {
2 "maxObjectCount": 10000,
3 "maxCapacityMegaBytes": 12341234
4}
5bos_client.put_bucket_quota(bucket_name, quota_conf=quota_conf)注意：
- 只有 Bucket 的 owner 且拥有
FULL_CONTROL权限才能够进行此请求。maxObjectCount与maxCapacityMegaBytes取值需大于等于 -1，否则服务端返回错误。- Bucket 级额度与目录级额度不能同时设置。
参数说明
| 参数 | 必填 | 说明 | 备注 |
|---|---|---|---|
bucket_name |
是 | Bucket 名称。 | - |
quota_conf |
是 | Bucket 额度配置，包含额度限制字段的字典。 | - |
maxObjectCount |
否 | 单个 Bucket 最大对象个数限制值。 | 取值需大于等于 -1，其中 -1 表示不限制；缺省为 0。 |
maxCapacityMegaBytes |
否 | 单个 Bucket 最大容量限制值，单位为 MB。 | 取值需大于等于 -1，其中 -1 表示不限制；缺省为 0。 |
获取 Bucket 额度管理
Python
1response = bos_client.get_bucket_quota(bucket_name)
2print(response.max_object_count)
3print(response.max_capacity_mega_bytes)参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
bucket_name |
是 | Bucket 名称。 |
返回值说明如下：
| 返回值 | 说明 |
|---|---|
response.max_object_count |
单个 Bucket 最大个数限制值。 |
response.max_capacity_mega_bytes |
单个 Bucket 最大容量限制值，单位为 MB。 |
删除 Bucket 额度管理
Python
1response = bos_client.delete_bucket_quota(bucket_name)参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
bucket_name |
是 | Bucket 名称。 |
评价此篇文章