GetResourcePoolRequesterQoSInfo - Object Storage Service

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 can call this operation. To make requests as a RAM user or by using Security Token Service (STS), you must have the oss:GetResourcePoolRequesterQoSInfo permission. For more information, see Common examples of RAM policies.

Syntax

GET /?requesterQosInfo&resourcePool=ResourcePoolName&qosRequester=uid
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 HTTP headers.

Request elements

Element	Type	Required	Example	Description
resourcePool	String	Yes	resource-pool-for-ai	Name of the resource pool.
qosRequester	String	Yes	300xxxx	User ID (UID) of the requester.

Response headers

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

Response elements

Element	Type	Example	Description
RequesterQoSInfo	Container	N/A	Container for the query result. Parent nodes: none
Requester	String	300xxxx	User ID (UID) of the requester. Parent node: RequesterQoSInfo
QoSConfiguration	Container	N/A	Container for the requester's throttling configurations. Parent node: RequesterQoSInfo
TotalUploadBandwidth	Integer	10	Total upload bandwidth specified by the requester for the resource pool. Unit: Gbit/s. Parent node: QoSConfiguration
IntranetUploadBandwidth	Integer	-1	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 node: QoSConfiguration
ExtranetUploadBandwidth	Integer	-1	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 node: QoSConfiguration
TotalDownloadBandwidth	Integer	10	Total download bandwidth specified by the requester for the resource pool. Unit: Gbit/s. Parent node: QoSConfiguration
IntranetDownloadBandwidth	Integer	-1	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 node: QoSConfiguration
ExtranetDownloadBandwidth	Integer	-1	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 node: QoSConfiguration

Example

Sample request

GET /?requesterQosInfo&resourcePool=resource-pool-for-ai&qosRequester=300xxxx
Host: 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

Sample response

HTTP/1.1 200 OK
Date: Fri, 27 Dec 2024 03:21:12 GMT
Content-Type: application/xml
Content-Length: 452

<RequesterQoSInfo>
  <Requester>300xxxx</Requester>
  <QoSConfiguration>
    <TotalUploadBandwidth>10</TotalUploadBandwidth>
    <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
    <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
    <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
    <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
    <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
  </QoSConfiguration>
</RequesterQoSInfo>

OSS SDKs

You can use OSS SDKs for the following programming languages to call this operation:

ossutil

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