用户额度管理
更新时间：2026-09-21
put_user_quota
此接口用来设置用户的额度，额度包括总的 Bucket 数及各个 region 总的存储容量。当前总的 Bucket 数最大值不能超过 100。
注意： 该接口只能被主用户调用。
参数说明：
| 参数 | 必填 | 说明 |
|---|---|---|
max_bucket_count |
是 | 最大可以创建的 Bucket 数。当前总的 Bucket 数最大值不能超过 100；若为 -1，则表示不设置。 |
max_capacity_mega_bytes |
是 | 最大的存储容量，单位为 MB；若为 -1 或 0，表示不设置存储容量额度限制，即无上限。 |
max_object_count |
是 | 最多 object 数量；若为 -1 或 0，表示不设置object个数额度，即无上限。 |
Python
1from baidubce.auth.bce_credentials import BceCredentials
2from baidubce.bce_client_configuration import BceClientConfiguration
3from baidubce.services.bos.bos_client import BosClient
4
5access_key_id = "your-access-key-id"
6secret_access_key = "your-secret-access-key"
7endpoint = "https://bj.bcebos.com"
8
9config = BceClientConfiguration(
10 credentials=BceCredentials(access_key_id, secret_access_key),
11 endpoint=endpoint,
12)
13bos_client = BosClient(config)
14
15max_bucket_count = 100
16max_capacity_mega_bytes = -1
17max_object_count = 1000
18
19response = bos_client.put_user_quota(max_bucket_count, max_capacity_mega_bytes, max_object_count)调用成功后返回 SDK 响应对象。可通过 get_user_quota() 查看用户额度设置。
get_user_quota
此接口用来查看用户的额度设置。
注意： 该接口只能被主用户调用。
Python
1from baidubce.auth.bce_credentials import BceCredentials
2from baidubce.bce_client_configuration import BceClientConfiguration
3from baidubce.services.bos.bos_client import BosClient
4
5access_key_id = "your-access-key-id"
6secret_access_key = "your-secret-access-key"
7endpoint = "https://bj.bcebos.com"
8
9config = BceClientConfiguration(
10 credentials=BceCredentials(access_key_id, secret_access_key),
11 endpoint=endpoint,
12)
13bos_client = BosClient(config)
14
15response = bos_client.get_user_quota()
16print("[Sample] get user quota maxBucketCount:", response.max_bucket_count)
17print("[Sample] get user quota maxCapacityMegaBytes:", response.max_capacity_mega_bytes)参数说明：该方法无请求参数。
返回值说明：
| 返回字段 | 说明 |
|---|---|
response.max_bucket_count |
最大可以创建的 Bucket 数。 |
response.max_capacity_mega_bytes |
最大的存储容量，单位为 MB。 |
response.max_object_count |
允许最多 object 数量。 |
delete_user_quota
此接口用来删除额度设置。
注意： 该接口只能被主用户调用。
Python 示例：
Python
1from baidubce.auth.bce_credentials import BceCredentials
2from baidubce.bce_client_configuration import BceClientConfiguration
3from baidubce.services.bos.bos_client import BosClient
4
5access_key_id = "your-access-key-id"
6secret_access_key = "your-secret-access-key"
7endpoint = "https://bj.bcebos.com"
8
9config = BceClientConfiguration(
10 credentials=BceCredentials(access_key_id, secret_access_key),
11 endpoint=endpoint,
12)
13bos_client = BosClient(config)
14
15response = bos_client.delete_user_quota()参数说明：该方法无请求参数。
调用成功后返回 SDK 响应对象，并删除用户额度设置。
评价此篇文章