用户额度管理
更新时间：2026-09-23
运行以下示例前，请先参考初始化完成 BOS Client 初始化，并将示例中的占位符替换为实际值。
put_user_quota
此接口用来设置用户的额度，额度包括总的 Bucket 数、总的存储容量及总的对象个数。当前总的 Bucket 数最大值不能超过 100。
注意：
- 该接口只能被主用户调用。
max_bucket_count、max_capacity_mega_bytes、max_object_count三者至少指定一个，否则 SDK 会抛出ValueError；指定的字段必须为int类型，否则抛出TypeError。
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
max_bucket_count |
int | 否 | 最大可以创建的 Bucket 数。当前总的 Bucket 数最大值不能超过 100；若为 -1，则表示不设置。 |
max_capacity_mega_bytes |
int | 否 | 最大的存储容量，单位为 MB；若为 -1 或 0，表示不设置存储容量额度限制，即无上限。 |
max_object_count |
int | 否 | 最大的对象个数；若为 -1，则表示不设置。 |
Python
1max_bucket_count = 100
2max_capacity_mega_bytes = -1
3max_object_count = -1
4
5response = bos_client.put_user_quota(max_bucket_count, max_capacity_mega_bytes, max_object_count)调用成功后返回 SDK 响应对象。可通过 get_user_quota() 查看用户额度设置。
get_user_quota
此接口用来查看用户的额度设置。
注意： 该接口只能被主用户调用。
Python
1response = bos_client.get_user_quota()
2print("[Sample] get user quota maxBucketCount:", response.max_bucket_count)
3print("[Sample] get user quota maxCapacityMegaBytes:", response.max_capacity_mega_bytes)
4print("[Sample] get user quota maxObjectCount:", response.max_object_count)参数说明：该方法无请求参数。
返回值说明：
| 返回字段 | 说明 |
|---|---|
response.max_bucket_count |
最大可以创建的 Bucket 数。 |
response.max_capacity_mega_bytes |
最大的存储容量，单位为 MB。 |
response.max_object_count |
最大的对象个数。 |
delete_user_quota
此接口用来删除额度设置。
注意： 该接口只能被主用户调用。
Python
1response = bos_client.delete_user_quota()参数说明：该方法无请求参数。
调用成功后返回 SDK 响应对象，并删除用户额度设置。
评价此篇文章