更新时间:2026-04-09 GMT+08:00
管理桶配额
使用场景
默认情况下,OBS系统和单个桶都没有总数据容量和对象数量的限制。您可以通过为桶设置配额限制来控制桶内允许上传的对象总容量,超过设置的对象容量后,上传对象会失败(返回HTTP状态码403 Forbidden,错误码InsufficientStorageSpace)。此时如果想要继续上传对象,请扩大配额,或取消配额限制(设置为0),或删除不需要的对象。
桶配额只对设置生效后的对象上传操作有限制, 如果设置的桶配额数值小于已经上传的对象容量,不会删除已有对象,但后续不能再上传任何对象。这种情况下只有删除部分已有对象,将已用空间释放到配额限制以下之后才能再次上传新对象。
约束限制
- 桶配额值必须为非负整数,单位为字节,支持的最大值为263 - 1。
- OBS没有提供删除桶配额的接口,您可以将桶配额设置为0来取消配额限制。
- 由于桶配额的校验依赖于桶存量,而桶存量是系统后台计算,因此桶配额可能不会及时生效,存在滞后性。可能会出现桶存量超出配额或者删除数据后存量未能及时回落的情况,桶存量查询接口请参见获取桶存量。
使用方式
OBS支持通过API和SDK方式管理桶配额,不支持通过管理控制台、OBS Browser+、obsutil方式管理桶配额。