GetBucketRequesterQoSInfo_对象存储(OSS)-阿里云帮助中心

调用GetBucketRequesterQoSInfo获取指定请求者在Bucket级别的流控配置。

注意事项

当前资源池QoS为邀测功能。您在某个地域的OSS性能达到500Gbps及以上，请联系技术支持申请使用。
阿里云账号默认拥有获取指定请求者在Bucket级别流控配置的权限。如果您需要通过RAM用户或者STS的方式进行获取，您必须拥有oss:GetBucketRequesterQoSInfo权限。具体操作，请参见RAM Policy常见示例。

请求语法

GET /?requesterQosInfo&qosRequester=uid
Host: BucketName.oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求元素

名称	类型	是否必选	示例值	描述

名称	类型	是否必选	示例值	描述
qosRequester	字符串	是	300xxxx	请求者UID。

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

响应元素

名称	类型	示例值	描述

名称	类型	示例值	描述
RequesterQoSInfo	容器	不涉及	保存请求结果的容器。父节点：无
Requester	字符串	300xxxx	请求者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&qosRequester=300xxxx
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: 515
x-oss-request-id: 534****

<RequesterQoSInfo>
  <Requester>300xxxx</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>

命令行工具ossutil

GetBucketRequesterQoSInfo接口所对应的ossutil命令，请参见get-bucket-requester-qos-info。