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

调用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	本次返回结果是否截断。 true表示本次没有返回全部结果。 false表示本次已经返回了全部结果。父节点：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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

返回示例

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>
    </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>
    </QoSConfiguration>
  </RequesterQoSInfo>
</ListBucketRequesterQoSInfosResult>

SDK

ListBucketRequesterQoSInfos接口所对应的各语言SDK如下：

命令行工具ossutil

ListBucketRequesterQoSInfos接口所对应的ossutil命令，请参见list-bucket-requester-qos-infos。