This topic was translated by AI and is currently in queue for revision by our editors. Alibaba Cloud does not guarantee the accuracy of AI-translated content. Request expedited revision
Home PageObject Storage ServiceDeveloper ReferenceDeveloper GuideAPI ReferenceOperations related to the resource pool QoSGetResourcePoolInfo
Search for Help Content

GetResourcePoolInfo

Updated at: 2025-02-18 03:24
Product
Community

Invoke GetResourcePoolInfo to retrieve details about a specific resource pool.

Notes

  • Resource pool QoS is in invitational preview. If the throughput of your OSS buckets in a region has reached or exceeded 500 Gbps, you can contact technical support to apply for this feature.

  • By default, an Alibaba Cloud account is authorized to query the throttling configurations of a resource pool. Access via a RAM user or Security Token Service (STS) requires the oss:GetResourcePoolInfo permission. For detailed instructions, see RAM policy common examples.

Request syntax

GET /?resourcePoolInfo&resourcePool=ResourcePoolName
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request headers

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

Request elements

Name

Type

Required

Example value

Description

Name

Type

Required

Example value

Description

resourcePool

String

Yes

resource-pool-for-ai

The name of the resource pool.

Response headers

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

Response elements

Name

Type

Example value

Description

Name

Type

Example value

Description

GetResourcePoolInfoResponse

Container

N/A

The container that stores the result of the request.

Parent nodes: none

Region

String

oss-cn-hangzhou

The region in which the resource pool resides.

Parent nodes: GetResourcePoolInfoResponse

Name

String

resource-pool-for-ai

The name of the resource pool.

Parent nodes: GetResourcePoolInfoResponse

Owner

String

103xxxx

The unique identifier (UID) of the account to which the resource pool belongs.

Parent nodes: GetResourcePoolInfoResponse

CreateTime

String

2024-11-29T08:42:32.000Z

The time when the resource pool was created. The time follows the ISO 8601 standard.

Parent nodes: GetResourcePoolInfoResponse

QoSConfiguration

Container

N/A

The container that stores the throttling configurations of the resource pool.

Parent nodes: GetResourcePoolInfoResponse

TotalUploadBandwidth

Integer

10

The total upload bandwidth of the resource pool. Unit: Gbit/s.

Parent nodes: QoSConfiguration

IntranetUploadBandwidth

Integer

-1

The upload bandwidth of the resource pool over internal networks. Internal networks include the classic network and virtual private clouds (VPCs). Unit: Gbit/s.

The value -1 indicates that the upload bandwidth over internal networks is not limited.

Parent nodes: QoSConfiguration

ExtranetUploadBandwidth

Integer

-1

The upload bandwidth of the resource pool over public networks. Public networks include the Internet and acceleration endpoints. Unit: Gbit/s.

Parent nodes: QoSConfiguration

TotalDownloadBandwidth

Integer

10

The total download bandwidth of the resource pool. Unit: Gbit/s.

Parent nodes: QoSConfiguration

IntranetDownloadBandwidth

Integer

-1

The download bandwidth of the resource pool over internal networks. Internal networks include the classic network and VPCs. Unit: Gbit/s.

The value -1 indicates that the download bandwidth over internal networks is not limited.

Parent nodes: QoSConfiguration

ExtranetDownloadBandwidth

Integer

-1

The download bandwidth of the resource pool over public networks. Public networks include the Internet and acceleration endpoints. Unit: Gbit/s.

Parent nodes: QoSConfiguration

Example

  • Query Example

    GET /?resourcePoolInfo&resourcePool=resource-pool-for-ai
Host: oss-cn-hangzhou.aliyuncs.com
Date: Fri, 27 Dec 2024 03:21:12 GMT
Authorization: OSS qn6q****:77Dv****

  • Sample Response

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

<?xml version="1.0" encoding="UTF-8"?>
<GetResourcePoolInfoResponse>
  <Region>oss-cn-hangzhou</Region>
  <Name>resource-pool-for-ai</Name>
  <Owner>103xxxx</Owner>
  <CreateTime>2024-11-29T08:42:32.000Z</CreateTime>
  <QoSConfiguration>
    <TotalUploadBandwidth>10</TotalUploadBandwidth>
    <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
    <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
    <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
    <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
    <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
  </QoSConfiguration>
</GetResourcePoolInfoResponse>

Command line tool ossutil

For the ossutil command corresponding to the GetResourcePoolInfo operation, see get-resource-pool-info.

Previous: ListResourcePoolsNext: ListResourcePoolBuckets
  • On this page （1）
  • Notes
  • Request syntax
  • Request headers
  • Request elements
  • Response headers
  • Response elements
  • Example
  • Command line tool ossutil
Feedback