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

调用ListResourcePoolBucketGroupQoSInfos列举资源池中BucketGroup的流控配置。

注意事项

当前资源池QoS为邀测功能。您在某个地域的OSS性能达到500Gbps及以上，请联系技术支持申请使用。
阿里云账号默认拥有全部权限。如果通过RAM用户或者RAM角色的方式进行列举，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予oss:ListResourcePoolBucketGroupQoSInfos权限。

请求语法

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

请求头

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

请求元素

名称	类型	是否必选	示例值	描述
resourcePool	字符串	是	resource-pool-for-ai	资源池名称。
max-keys	整数	否	2	限定此次返回BucketGroup的最大数量。
continuation-token	字符串	否	abcd	限定从哪个BucketGroup开始返回信息。

响应头

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

响应元素

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

示例

请求示例

GET /?resourcePoolBucketGroupQosInfo&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: 1386
x-oss-request-id: 534B************

<?xml version="1.0" encoding="UTF-8"?>
<ListResourcePoolBucketGroupQoSInfosResult>
  <ResourcePool>resource-pool-for-ai</ResourcePool>
  <ContinuationToken>1105678</ContinuationToken>
  <NextContinuationToken>3105678</NextContinuationToken>
  <IsTruncated>true</IsTruncated>
  <ResourcePoolBucketGroupQoSInfo>
    <BucketGroup>test-group</BucketGroup>
    <QoSConfiguration>
      <TotalUploadBandwidth>10</TotalUploadBandwidth>
      <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
      <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
      <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
      <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
      <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
    </QoSConfiguration>
  </ResourcePoolBucketGroupQoSInfo>
  <ResourcePoolBucketGroupQoSInfo>
    <BucketGroup>test-group-02<BucketGroup/>
    <QoSConfiguration>
      <TotalUploadBandwidth>10</TotalUploadBandwidth>
      <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
      <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
      <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
      <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
      <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
    </QoSConfiguration>
  </ResourcePoolBucketGroupQoSInfo>
</ListResourcePoolBucketGroupQoSInfosResult>

SDK

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