全部文档
当前文档
最近更新时间：2025-11-03 20:44:44
该接口用于设置桶配额，调用该接口的用户必须是主账号或具有ks3:PutBucketQuota权限。
1. 如果您的桶已设置桶配额规则，新添加的规则将覆盖旧规则，请注意避免误删。
2. 您可以通过设置桶配额来控制桶内允许上传的对象总容量，超过设置的配额容量后，上传对象将会失败。
3. 桶容量包括：桶内文件/碎片、回收站内文件、未满足最低存储时长删除的低频或归档类型文件。
4. 如果您想查看桶内文件总容量，可以通过KS3控制台、API、Util工具等方式查看。
5. 桶容量大于等于桶配额值时，上传对象将会返回403 Forbidden状态码，错误码为InsufficientStorageSpace。如果您想继续上传对象成功，可以采用删除对象、扩大桶配额额度、删除桶配额规则等方式。
6. 桶容量大于等于桶配额时，一切关于增加桶容量相关的操作均会失败，包括数据复制到桶内，上传文件（新增/覆盖）、上传分块等相关操作。
7. 低频或归档类型文件有最低存储时长要求，删除后将会持续计量直至达到最低存储时长，因此该场景下删除文件不会立即导致桶容量减少。
8. 桶配额针对包括主账号在内的全部用户均生效。
9. 桶配额只对生效后的增量上传有限制， 如果设置的桶配额值小于桶容量，不会删除已有对象，但不能再上传新的对象。只能通过删除对象、扩大桶配额额度、删除桶配额规则等方式继续上传对象。
10. 设置或修改桶配额的值后，预计5分钟内生效。
11. 由于桶的容量值是后台自动计算，并非实时更新（延时预计3小时左右），因此可能会出现桶容量超出配额或者删除数据后桶容量未能及时回落的情况，包括：
（a）桶容量超出配额：上传文件后，由于后台计算的滞后性，系统可能未能及时检测到这种变化，导致桶的存储量超过了其配额限制。
（b）删除数据后桶容量未能及时回落：当桶中的部分数据被删除后，由于同样的滞后性，系统可能未能立即更新桶的存储量，导致删除文件后未能立即释放容量。
PUT /?quota HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
Content-length: {length}
Quota configuration in the request body该请求仅使用公共请求头。
一段描述桶配额规则的XML：
<Quota>
<StorageQuota>10240000</StorageQuota>
</Quota>请求体内相关元素的具体描述如下：
名称 | 是否必选 | 说明 |
Quota | 是 | 包含桶配额相关规则的容器。单个桶仅支持设置一条规则。
|
StorageQuota | 是 | 指定桶配额值，单位为字节。
|
该接口只返回常用响应头部。
该接口不返回响应体。
PUT /?quota HTTP/1.1
Host: examplebucket.ks3-cn-beijing.ksyuncs.com
Date: Wed, 14 May 2014 02:11:21 GMT
Authorization: authorization string
Content-Length: yyy
Content-type: application/xml
<Quota>
<StorageQuota>10240000</StorageQuota>
</Quota>HTTP/1.1 200 OK
Content-Length: 0
Connection: keep-alive
Date: Tue, 19 Jul 2017 09:14:23 GMT
Server: KS3
x-kss-request-id: 6af24440694b4d00b8de063ccbe8****HTTP 状态码 | 错误码 | 描述 |
400 Bad Request | InvalidRequest | 请求不合法。 |
403 Forbidden | AccessDenied | 缺少权限。 |
404 Not Found | NoSuchBucket | 桶不存在。 |
400 Bad Request | InvalidArgument | StorageQuota超过取值范围。 |
400 Bad Request | InvalidArgument | 参数为空、参数无效、参数值填写的不合法。 |
纯净模式