全部文档
当前文档
最近更新时间：2026-01-20 15:07:20
该接口用于为桶设置带宽限流，使用该接口的用户，必须是桶拥有者或具有ks3:PutBucketQos权限。
1. 如需为子用户配置ks3:PutBucketQos权限，请在IAM控制台新建权限策略后（通过策略语法的方式），为子用户添加策略。
2. 规则设置成功后，预计1分钟内生效。
3. 单个请求者的流控配置值（RequesterQos），不能超过所属桶的桶流控配置值（BucketQos）；多个请求者的流控配置值之和，可超过所属桶的桶流控配置值，但实际请求时，所有请求者的带宽总和不能超过桶流控上限。
4. 如果桶存在流控规则，删除桶操作将会失败。
5. 桶流控为邀测功能，如有需要请联系商务或提交工单申请。
PUT /?bucketqos HTTP/1.1
Host: {bucket}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
Content-Type: application/xml
Bucketqos written in XML该接口不使用请求参数。
该接口仅使用公共请求头。
请求体为一段描述桶限流规则的XML：
<BucketQosConfiguration>
<Quota>
<StorageMedium>Normal</StorageMedium>
<ExtranetUploadBandwidth>1000</ExtranetUploadBandwidth>
<IntranetUploadBandwidth>1000</IntranetUploadBandwidth>
<ExtranetDownloadBandwidth>1000</ExtranetDownloadBandwidth>
<IntranetDownloadBandwidth>1000</IntranetDownloadBandwidth>
</Quota>
</BucketQosConfiguration>XML中的节点具体描述如下：
名称 | 描述 | 是否必选 |
|---|---|---|
BucketQosConfiguration | 桶流控配置的容器。 | 是 |
Quota | 设置流控配额的容器。
| 是 |
StorageMedium | 指定需要配置流控规则的存储介质类型。
| 是 |
ExtranetUploadBandwidth | 外网上传带宽，单位为Gbps，值必须是正整数。
| 否 |
IntranetUploadBandwidth | 内网上传带宽，单位为Gbps，值必须是正整数。
| 否 |
ExtranetDownloadBandwidth | 外网下行带宽，单位为 Gbps，值必须是正整数。
| 否 |
IntranetDownloadBandwidth | 内网下行带宽，单位为 Gbps，值必须是正整数。
| 否 |
该接口仅返回常用响应头部。
该接口不返回响应内容。
PUT /?bucketqos HTTP/1.1
Host: {bucket}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<BucketQosConfiguration>
<Quota>
<StorageMedium>Normal</StorageMedium>
<OccupyExtranetUploadBandwidth>1000</OccupyExtranetUploadBandwidth>
<OccupyIntranetUploadBandwidth>1000</OccupyIntranetUploadBandwidth>
<OccupyExtranetDownloadBandwidth>1000</OccupyExtranetDownloadBandwidth>
<OccupyIntranetDownloadBandwidth>1000</OccupyIntranetDownloadBandwidth>
</Quota>
</BucketQosConfiguration>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: 54a47bda18ac4e6e91de369add54218***纯净模式