ListResourcePoolRequesterQoSInfos - Object Storage Service

Usage notes

Resource pool QoS is in invitational preview. If the throughput of your OSS buckets in a region has reached or exceeded 500 Gbit/s, you can contact technical support to apply for this feature.
By default, an Alibaba Cloud account has the permissions to call this operation. To call this operation by using a RAM user or Security Token Service (STS), you must have the oss:ListResourcePoolRequesterQoSInfos permission. For more information, see Common examples of RAM policies.

Syntax

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

Request headers

This operation uses only common request headers. For more information, see Common request headers.

Request elements

Element	Type	Required	Example	Description
resourcePool	String	Yes	resource-pool-for-ai	The name of the resource pool.
max-keys	Integer	No	2	The maximum number of requester throttling configurations to return.
continuation-token	String	No	1105678	The requester from which to start returning throttling configurations.

Response headers

This operation uses only common response headers. For more information, see Common response headers.

Response elements

Element	Type	Example	Description
ListResourcePoolRequesterQoSInfosResult	Container	N/A	The container for the query result. Parent nodes: none
ResourcePool	String	resource-pool-for-ai	The name of the resource pool. Parent nodes: ListResourcePoolRequesterQoSInfosResult
ContinuationToken	String	1105678	The continuation token that was used in this request. Parent nodes: ListResourcePoolRequesterQoSInfosResult
NextContinuationToken	String	3105678	The token used to retrieve the next page of results. Set continuation-token to this value in a subsequent request to retrieve additional results. Parent nodes: ListResourcePoolRequesterQoSInfosResult
IsTruncated	Boolean	true	Indicates whether the queried results are truncated. true: Not all results are returned. false: All results are returned. Parent nodes: ListResourcePoolBucketsResult
RequesterQoSInfo	Container	N/A	The container for the throttling configurations of a requester. Parent nodes: ListResourcePoolRequesterQoSInfosResult
Requester	String	311xxxx	The user ID (UID) of the requester. Parent nodes: RequesterQoSInfo
QoSConfiguration	Container	N/A	The container for the throttling configuration of a requester. Parent nodes: RequesterQoSInfo
TotalUploadBandwidth	Integer	10	The total upload bandwidth specified by the requester for the resource pool. Unit: Gbit/s. Parent nodes: QoSConfiguration
IntranetUploadBandwidth	Integer	-1	The upload bandwidth over an internal network specified by the requester for the resource pool. Internal networks include the classic network and VPC. Unit: Gbit/s. Parent nodes: QoSConfiguration
ExtranetUploadBandwidth	Integer	-1	The upload bandwidth over a public network specified by the requester for the resource pool. Public networks include the Internet and acceleration endpoints. Unit: Gbit/s. Parent nodes: QoSConfiguration
TotalDownloadBandwidth	Integer	10	The total download bandwidth specified by the requester for the resource pool. Unit: Gbit/s. Parent nodes: QoSConfiguration
IntranetDownloadBandwidth	Integer	-1	The download bandwidth over an internal network specified by the requester for the resource pool. Internal networks include the classic network and VPC. Unit: Gbit/s. Parent nodes: QoSConfiguration
ExtranetDownloadBandwidth	Integer	-1	The download bandwidth over a public network specified by the requester for the resource pool. Public networks include the Internet and acceleration endpoints. Unit: Gbit/s. Parent nodes: QoSConfiguration

Examples

Sample requests

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

Sample success responses

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>

OSS SDKs

You can call this operation by using OSS SDKs for the following programming languages:

ossutil

For the ossutil command that corresponds to this operation, see list-resource-pool-requester-qos-infos.