使用ListResourcePoolRequesterQoSInfos列出资源池内所有请求者的流控配置-对象存储-阿里云

调用ListResourcePoolRequesterQoSInfos获取所有请求者在资源池的流控配置。

注意事项

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

请求语法

GET /?requesterQosInfo&resourcePool=ResourcePoolName&max-keys=2&continuation-token=1105678
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

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

请求元素

名称	类型	是否必选	示例值	描述
resourcePool	字符串	是	resource-pool-for-ai	请求的目标资源池名称。
max-keys	整数	否	2	限定此次请求最多返回多少个请求者的流控信息。
continuation-token	字符串	否	1105678	限定从哪个请求者开始返回流控信息。

响应头

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

响应元素

名称	类型	示例值	描述
ListResourcePoolRequesterQoSInfosResult	容器	不涉及	保存请求结果的容器。父节点：无
ResourcePool	字符串	resource-pool-for-ai	资源池名称。父节点：ListResourcePoolRequesterQoSInfosResult
ContinuationToken	字符串	1105678	本次列举请求使用的ContinuationToken。父节点：ListResourcePoolRequesterQoSInfosResult
NextContinuationToken	字符串	3105678	表明此次列举请求包含后续结果，需要将NextContinuationToken指定为下次列举请求的起点，继续获取结果。父节点：ListResourcePoolRequesterQoSInfosResult
IsTruncated	布尔值	true	本次返回结果是否被截断。 true表示本次没有返回全部结果。 false表示本次已经返回了全部结果。父节点：ListResourcePoolBucketsResult
RequesterQoSInfo	容器	不涉及	保存请求者流控配置信息的容器。父节点：ListResourcePoolRequesterQoSInfosResult
Requester	字符串	311xxxx	请求者的UID。父节点：RequesterQoSInfo
QoSConfiguration	容器	不涉及	保存请求者流控配置信息的容器。父节点：RequesterQoSInfo
TotalUploadBandwidth	整数	10	请求者在资源池级别的总上传带宽，单位Gbps。父节点：QoSConfiguration
IntranetUploadBandwidth	整数	-1	请求者在资源池级别的内网上传带宽，包括经典网络和VPC网络的内网上传带宽，单位Gbps。父节点：QoSConfiguration
ExtranetUploadBandwidth	整数	-1	请求者在资源池级别的外网上传带宽，包括公网和传输加速域名的上传带宽，单位Gbps。父节点：QoSConfiguration
TotalDownloadBandwidth	整数	10	请求者在资源池级别的总下载带宽，单位Gbps。父节点：QoSConfiguration
IntranetDownloadBandwidth	整数	-1	请求者在资源池级别的内网下载带宽，包括经典网络和VPC网络的内网下载带宽，单位Gbps。父节点：QoSConfiguration
ExtranetDownloadBandwidth	整数	-1	请求者在资源池级别的外网下载带宽，包括公网和传输加速域名的下载带宽，单位Gbps。父节点：QoSConfiguration

示例

请求示例

GET /?requesterQosInfo&resourcePool=resource-pool-for-ai&continuation-token=1105678&max-keys=2
Host: oss-cn-shanghai.aliyuncs.com
Date: Sun, 11 Aug 2024 17:45:00 GMT
Authorization: SignatureValue

返回示例

HTTP/1.1 200 OK
Date: Sun, 11 Aug 2024 17:45:00 GMT
Content-Length: conetent length
x-oss-request-id: 1265

<?xml version="1.0" encoding="UTF-8"?>
<ListResourcePoolRequesterQoSInfosResult>
  <ResourcePool>resource-pool-for-ai</ResourcePool>
  <ContinuationToken>1105678</ContinuationToken>
  <NextContinuationToken>3105678</NextContinuationToken>
  <IsTruncated>true</IsTruncated>
  <RequesterQoSInfo>
    <Requester>311xxxx</Requester>
    <QoSConfiguration>
      <TotalUploadBandwidth>10</TotalUploadBandwidth>
      <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
      <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
      <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
      <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
      <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
    </QoSConfiguration>
  </RequesterQoSInfo>
  <RequesterQoSInfo>
    <Requester>312xxxx</Requester>
    <QoSConfiguration>
      <TotalUploadBandwidth>10</TotalUploadBandwidth>
      <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
      <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
      <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
      <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
      <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
    </QoSConfiguration>
  </RequesterQoSInfo>
</ListResourcePoolRequesterQoSInfosResult>

SDK

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

命令行工具ossutil

ListResourcePoolRequesterQoSInfos接口所对应的ossutil命令，请参见list-resource-pool-requester-qos-infos。