文档中心 对象存储(KS3) 用户指南 空间管理(Bucket) 空间配额

空间配额

最近更新时间:2026-06-23 19:12:28

空间配额功能支持对存储桶的容量、流量、请求次数设置使用上限,帮助您精细化管控存储成本,防止资源滥用和意外支出。超过设置的配额后,相关操作将会报错。

KS3支持设置的配额维度包括:

  • 容量

  • 流量:外网上行流量、外网下行流量、内网上行流量、内网下行流量、CDN上行流量、CDN下行流量

  • 请求次数:PUT类请求次数(包含PUT、POST、DELETE请求)、GET类请求次数(包含GET、HEAD请求)、LIST请求次数

说明

1. 全局说明

  1. 设置或修改空间配额的值后,预计5分钟内生效。

  2. 空间配额针对包括主账号在内的全部用户均生效。

2. 容量配额相关说明

  1. 桶容量大于等于桶容量配额时,一切关于增加桶容量相关的操作均会失败,包括数据复制到桶内,上传文件(新增/覆盖)、上传分块等相关操作。

  2. 桶容量包括:桶内文件/碎片、回收站内文件、未满足最低存储时长删除的低频、归档或冷归档类型文件。

  3. 如果您想查看桶内文件总容量,可以通过KS3控制台APIUtil工具等方式查看。

  4. 低频或归档类型文件有最低存储时长要求,删除后将会持续计量直至达到最低存储时长,因此该场景下删除文件不会立即导致桶容量减少。

  5. 桶容量大于等于空间配额值时,上传对象将会失败。如果您想继续上传对象成功,可以采用删除对象、扩大空间配额额度、删除空间配额规则等方式。

  6. 桶容量配额只对生效后的增量上传有限制, 如果设置的空间配额值小于桶容量,不会删除已有对象,但不能再上传新的对象。只能通过删除对象、扩大空间配额额度、删除空间配额规则等方式继续上传对象。

  7. 由于桶的容量值是后台自动计算,并非实时更新(延时预计3小时左右),因此可能会出现桶容量超出容量配额或者删除数据后桶容量未能及时回落的情况,包括:

    • 桶容量超出配额:上传文件后,由于后台计算的滞后性,系统可能未能及时检测到这种变化,导致桶的存储量超过了其配额限制。

    • 删除数据后桶容量未能及时回落:当桶中的部分数据被删除后,由于同样的滞后性,系统可能未能立即更新桶的存储量,导致删除文件后未能立即释放容量。

3. 流量及请求次数配额相关说明

  1. 当前仅北京区域支持流量和请求次数配额,其他区域暂不支持。

  2. 统计延迟约1分钟,因此可能存在实际使用量短暂超过配额值情况。

  3. 仅统计客户主动发起的请求,系统内部服务产生的流量和请求次数不计入统计用量(包括生命周期、回源、复制(CRR/SRR)、批量处理、在线解压等)。

  4. 每次请求到达时,系统会根据已统计用量与配额进行校验:

    • 当前累计用量未达到配额:允许请求。

    • 当前累计用量达到或超过配额:请求失败并返回配额超限错误。

  5. 规则创建后开始统计,修改规则后将沿用当前已统计的用量,删除规则后再创建规则,流量和请求次数统计值将重新开始计算。

操作方式

控制台

  1. 登录KS3控制台

  2. 点击左侧的【存储空间】页签,进入存储空间列表。

  3. 点击目标存储空间名称,进入存储空间内,点击【空间设置】。

  4. 在空间设置界面找到对应的页签【空间配额】。

  5. 根据需求进行相关配置,支持存储配额、流量配额、请求配额三种类型配置,流量及请求配额支持“按自然天”和“按自然月”两种统计方式,“按自然天”表示每个自然天内的流量或请求次数不能超过设置值,“按自然月”表示每个自然月内的流量或请求次数不能超过设置值。

API

指定操作

文档链接

创建空间配额规则

PUT Bucket Quota

查看空间配额规则

GET Bucket Quota

删除空间配额规则

DELETE Bucket Quota

SDK

SDK

文档链接

Java SDK

管理存储空间配额(Java)

Go SDK

管理存储空间配额(Go)

Python SDK

管理存储空间配额(Python)

上一篇:保留策略
下一篇:对象管理(Object)
以上内容是否对您有帮助?
有帮助
没帮助