调用PutBucketRequesterQoSInfo设置请求者在Bucket级别的流控。
注意事项
当前资源池QoS为邀测功能。您在某个地域的OSS性能达到500Gbps及以上，请联系技术支持申请使用。
阿里云账号默认拥有配置请求者在Bucket级别流控的权限。如果您需要通过RAM用户或者STS的方式进行配置，您必须拥有
oss:PutBucketRequesterQoSInfo权限。具体操作，请参见RAM Policy常见示例。
请求语法
PUT /?requesterQosInfo&qosRequester=uid
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
<QoSConfiguration>
<TotalUploadBandwidth>10</TotalUploadBandwidth>
<IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
<ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
<TotalDownloadBandwidth>10</TotalDownloadBandwidth>
<IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
<ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
<TotalQps>-1</TotalQps>
<IntranetQps>-1</IntranetQps>
<ExtranetQps>-1</ExtranetQps>
</QoSConfiguration>请求头
此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。
请求元素
以下带宽配置项中，取值为-1（默认值）表示不限制带宽。取值为0，表示禁止该类型的带宽，例如ExtranetUploadBandwidth取值为0，表示禁止通过外网上传数据到指定Bucket。
Bucket级别的请求者带宽配置不能超过Bucket总的带宽配置。例如，Bucket总下载带宽配置为100Gbps，则Bucket的请求者外网下载带宽不能超过100Gbps。
请求者各项带宽限制不能低于5Gbps。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
qosRequester | 字符串 | 是 | 300xxxx | 请求者UID。 父节点：无 |
QoSConfiguration | 容器 | 是 | 不涉及 | 保存结果的容器。 父节点：无 |
TotalUploadBandwidth | 整数 | 是 | 10 | 请求者在Bucket级别的总上传带宽，单位Gbps。 父节点：QoSConfiguration |
IntranetUploadBandwidth | 整数 | 是 | -1 | 请求者在Bucket级别的内网上传带宽，包括经典网络和VPC网络的内网上传带宽，单位Gbps。 父节点：QoSConfiguration |
ExtranetUploadBandwidth | 整数 | 是 | -1 | 请求者在Bucket级别的外网上传带宽，包括公网和传输加速域名的上传带宽，单位Gbps。 父节点：QoSConfiguration |
TotalDownloadBandwidth | 整数 | 是 | 10 | 请求者在Bucket级别的总下载带宽，单位Gbps。 父节点：QoSConfiguration |
IntranetDownloadBandwidth | 整数 | 是 | -1 | 请求者在Bucket级别的内网下载带宽，包括经典网络和VPC网络的内网下载带宽，单位Gbps。 父节点：QoSConfiguration |
ExtranetDownloadBandwidth | 整数 | 是 | -1 | 请求者在Bucket级别的外网下载带宽，包括公网和传输加速域名的下载带宽，单位Gbps。 父节点：QoSConfiguration |
响应头
此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。
示例
请求示例
PUT /?requesterQosInfo&qosRequester=300xxxx Host: oss-example.oss-cn-hangzhou.aliyuncs.com Content-Length: 209 Date: Fri, 27 Dec 2024 03:21:12 GMT Authorization: OSS qn6q****:77Dv**** <?xml version="1.0" encoding="UTF-8"?> <QoSConfiguration> <TotalUploadBandwidth>10</TotalUploadBandwidth> <IntranetUploadBandwidth>-1</IntranetUploadBandwidth> <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth> <TotalDownloadBandwidth>10</TotalDownloadBandwidth> <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth> <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth> </QoSConfiguration>返回示例
HTTP/1.1 200 OK x-oss-request-id: 534**** Date: Fri, 27 Dec 2024 03:21:12 GMT Content-Length: 0 Connection: keep-alive Server: AliyunOSS
命令行工具ossutil
PutBucketRequesterQoSInfo接口所对应的ossutil命令，请参见put-bucket-requester-qos-info。