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