全部文档
当前文档
最近更新时间：2026-06-17 12:07:47
桶配额功能支持对存储桶的容量、流量、请求次数设置使用上限，帮助您精细化管控存储成本，防止资源滥用和意外支出。超过设置的配额后，相关操作将会报错。调用该接口的用户必须是主账号或具有ks3:PutBucketQuota权限。
该接口支持设置的配额维度包括：
容量
流量：外网上行流量、外网下行流量、内网上行流量、内网下行流量、CDN上行流量、CDN下行流量
请求次数：PUT类请求次数（包含PUT、POST、DELETE请求）、GET类请求次数（包含GET、HEAD请求）、LIST请求次数
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>
<Day>
<IntranetFlowUp>10240000</IntranetFlowUp>
<IntranetFlowDown>10240000</IntranetFlowDown>
<ExtranetFlowUp>10240000</ExtranetFlowUp>
<ExtranetFlowDown>10240000</ExtranetFlowDown>
<CDNFlowUp>10240000</CDNFlowUp>
<CDNFlowDown>10240000</CDNFlowDown>
<Put>10240000</Put>
<Get>10240000</Get>
<List>10240000</List>
</Day>
<month>
<IntranetFlowUp>10240000</IntranetFlowUp>
<IntranetFlowDown>10240000</IntranetFlowDown>
<ExtranetFlowUp>10240000</ExtranetFlowUp>
<ExtranetFlowDown>10240000</ExtranetFlowDown>
<CDNFlowUp>10240000</CDNFlowUp>
<CDNFlowDown>10240000</CDNFlowDown>
<Put>10240000</Put>
<Get>10240000</Get>
<List>10240000</List>
</month>
</Quota>请求体内相关元素的具体描述如下：
名称 | 是否必选 | 说明 |
Quota | 是 | 包含桶配额相关规则的容器。单个桶仅支持设置一条规则。
|
StorageQuota | 否 | 指定桶容量配额值，单位为字节。
|
Day | 否 | 指定桶每天流量或请求次数可用配额值。
 Day和Month同时设置时，容器Day内配额值必须小于容器Month内对应维度配额值。 |
Month | 否 | 指定桶每月流量或请求次数可用配额值。
Day和Month同时设置时，容器Day内配额值必须小于容器Month内对应维度配额值。 |
IntranetFlowUp | 否 | 指定桶内网上行流量配额值，单位为字节，取值必须为正整数。
|
IntranetFlowDown | 否 | 指定桶内网下行流量配额值，单位为字节，取值必须为正整数。
|
ExtranetFlowUp | 否 | 指定桶外网上行流量配额值，单位为字节，取值必须为正整数。
|
ExtranetFlowDown | 否 | 指定桶外网下行流量配额值，单位为字节，取值必须为正整数。
|
CDNFlowUp | 否 | 指定桶CDN上行流量配额值，单位为字节，取值必须为正整数。
|
CDNFlowDown | 否 | 指定桶CDN下行流量配额值，单位为字节，取值必须为正整数。
|
Put | 否 | 指定桶PUT类请求次数配额值（包含PUT、POST、DELETE请求），单位为次，取值必须为正整数。
|
Get | 否 | 指定桶GET类请求次数配额值（包含GET、HEAD请求），单位为次，取值必须为正整数。
|
List | 否 | 指定桶List请求次数配额值，单位为次，取值必须为正整数。
|
该接口只返回常用响应头部。
该接口不返回响应体。
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>
<Day>
<IntranetFlowUp>10240000</IntranetFlowUp>
<IntranetFlowDown>10240000</IntranetFlowDown>
<ExtranetFlowUp>10240000</ExtranetFlowUp>
<ExtranetFlowDown>10240000</ExtranetFlowDown>
<CDNFlowUp>10240000</CDNFlowUp>
<CDNFlowDown>10240000</CDNFlowDown>
<Put>10240000</Put>
<Get>10240000</Get>
<List>10240000</List>
</Day>
<month>
<IntranetFlowUp>10240000</IntranetFlowUp>
<IntranetFlowDown>10240000</IntranetFlowDown>
<ExtranetFlowUp>10240000</ExtranetFlowUp>
<ExtranetFlowDown>10240000</ExtranetFlowDown>
<CDNFlowUp>10240000</CDNFlowUp>
<CDNFlowDown>10240000</CDNFlowDown>
<Put>10240000</Put>
<Get>10240000</Get>
<List>10240000</List>
</month>
</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 | 参数为空、参数无效、参数值填写的不合法。 |
400 Bad Request | InvalidArgument | 容器Day内配额大于或等于容器Month内对应维度配额值。 |
纯净模式