All Products
Search

This Product

    Object Storage Service:GetResourcePoolBucketGroupQoSInfo

    Document Center

    Object Storage Service:GetResourcePoolBucketGroupQoSInfo

    Last Updated:Jun 04, 2026

    Retrieves the throttling (QoS) configuration of a bucket group in a 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 Gbit/s, you can contact technical support to apply for this feature.

    • By default, Alibaba Cloud accounts have full permissions. To call this operation as a RAM user or with a RAM role, the Alibaba Cloud account or administrator must grant the oss:GetResourcePoolBucketGroupQoSInfo permission through RAM Policy or Bucket Policy.

    Request syntax

    GET /?resourcePoolBucketGroupQosInfo&resourcePool=<ResourcePoolName>&resourcePoolBucketGroup=<resourcePoolBucketGroupName>
Host: oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    Request headers

    This operation uses only Common Request Headers.

    Request parameters

    Name

    Type

    Required

    Example

    Description

    resourcePool

    string

    Yes

    resource-pool-for-ai

    The name of the resource pool.

    ResourcePoolBucketGroup

    string

    Yes

    test-group

    The name of the bucket group.

    Response headers

    This operation returns only Common Response Headers.

    Response elements

    Name

    Type

    Example

    Description

    ResourcePoolBucketGroupQoSInfo

    Container

    N/A

    Container for the bucket group throttling configuration in a resource pool.

    Parent nodes: none

    resourcePoolBucketGroup

    string

    test-group

    The name of the bucket group.

    Parent nodes: ResourcePoolBucketGroupQoSInfo

    QoSConfiguration

    Container

    N/A

    Container for the throttling configuration.

    Parent nodes: ResourcePoolBucketGroupQoSInfo

    TotalUploadBandwidth

    Integer

    10

    The total upload bandwidth of the bucket group. Unit: Gbps.

    Parent nodes: QoSConfiguration

    IntranetUploadBandwidth

    Integer

    -1

    Internal upload bandwidth of the bucket group, covering classic network and VPC. Unit: Gbps.

    Parent nodes: QoSConfiguration

    ExtranetUploadBandwidth

    Integer

    -1

    External upload bandwidth of the bucket group, covering public network and transfer acceleration endpoint. Unit: Gbps.

    Parent nodes: QoSConfiguration

    TotalDownloadBandwidth

    Integer

    10

    The total download bandwidth of the bucket group. Unit: Gbps.

    Parent nodes: QoSConfiguration

    IntranetDownloadBandwidth

    Integer

    -1

    Internal download bandwidth of the bucket group, covering classic network and VPC. Unit: Gbps.

    Parent nodes: QoSConfiguration

    ExtranetDownloadBandwidth

    Integer

    -1

    External download bandwidth of the bucket group, covering public network and transfer acceleration endpoint. Unit: Gbps.

    Parent nodes: QoSConfiguration

    Examples

    • Request example

      GET /?resourcePoolBucketGroupQosInfo&resourcePool=resource-pool-for-ai&resourcePoolBucketGroup=test-group
Host: oss-cn-shanghai.aliyuncs.com
Date: Sun, 11 Aug 2024 17:45:00 GMT
Authorization: SignatureValue

    • Response example

      HTTP/1.1 200 OK
Date: Sun, 11 Aug 2024 17:45:00 GMT
Content-Type: application/xml
Content-Length: 457

<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>

    OSS SDKs

    The following OSS SDKs support this operation: