调用ListBucketRequesterQoSInfos获取所有请求者在Bucket级别的流控配置。
注意事项
当前资源池QoS为邀测功能。您在某个地域的OSS性能达到500Gbps及以上，请联系技术支持申请使用。
阿里云账号默认拥有获取所有请求者在Bucket级别流控配置的权限。如果您需要通过RAM用户或者STS的方式进行获取，您必须拥有
oss:ListBucketRequesterQoSInfo权限。具体操作，请参见RAM Policy常见示例。
请求语法
GET /?requesterQosInfo&max-keys=10&continuation-token=207xxxx
Host: BucketName.oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue请求头
此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。
请求元素
名称 | 类型 | 是否必选 | 示例值 | 描述 |
max-keys | 字符串 | 否 | 10 | 限定此次返回请求者流控信息的最大条数。 |
continuation-token | 字符串 | 否 | 207xxxx | 限定从哪个请求者开始返回流控信息。 |
响应头
此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。
响应元素
名称 | 类型 | 示例值 | 描述 |
ListBucketRequesterQoSInfosResult | 容器 | 不涉及 | 保存请求结果的容器。 父节点：无 |
Bucket | 字符串 | oss-example | 返回请求者流控对应的Bucket名称。 父节点：ListBucketRequesterQoSInfosResult |
ContinuationToken | 字符串 | 207xxxx | 本次列举请求使用的ContinuationToken。 父节点：ListBucketRequesterQoSInfosResult |
NextContinuationToken | 字符串 | 262xxxx | 表明此次列举请求包含后续结果，需要将NextContinuationToken指定为下次列举请求的起点，继续获取结果。 父节点：ListBucketRequesterQoSInfosResult |
IsTruncated | 布尔值 | true | 本次返回结果是否截断。
父节点：ListBucketRequesterQoSInfosResult |
RequesterQoSInfo | 容器 | 不涉及 | 保存请求者流控配置信息的容器。 父节点：RequesterQoSInfo |
Requester | 字符串 | 266xxxx | 请求者UID。 父节点：RequesterQoSInfo |
QoSConfiguration | 容器 | 不涉及 | 保存请求者流控配置信息的容器。 父节点：RequesterQoSInfo |
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 |
示例
请求示例
GET /?requesterQosInfo&max-keys=2&continuation-token=207xxxx Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Fri, 27 Dec 2024 03:21:12 GMT Authorization: OSS qn6q****:77Dv****返回示例
HTTP/1.1 200 OK Date: Fri, 27 Dec 2024 03:21:12 GMT Content-Length: 1385 x-oss-request-id: 534**** <ListBucketRequesterQoSInfosResult> <Bucket>BucketName</Bucket> <ContinuationToken>207xxxx</ContinuationToken> <NextContinuationToken>262xxxx</NextContinuationToken> <IsTruncated>true</IsTruncated> <RequesterQoSInfo> <Requester>266xxxx</Requester> <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> </RequesterQoSInfo> <RequesterQoSInfo> <Requester>276xxxx</Requester> <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> </RequesterQoSInfo> </ListBucketRequesterQoSInfosResult>
命令行工具ossutil
ListBucketRequesterQoSInfos接口所对应的ossutil命令，请参见list-bucket-requester-qos-infos。