全部產品
Search
文件中心

Object Storage Service:ListResourcePoolBucketGroupQoSInfos

更新時間:May 28, 2025

調用ListResourcePoolBucketGroupQoSInfos列舉資源集區中BucketGroup的流控配置。

注意事項

  • 當前資源集區QoS為邀測功能。您在某個地區的OSS效能達到500Gbps及以上,請聯絡支援人員申請使用。

  • 阿里雲帳號預設擁有全部許可權。如果通過RAM使用者或者RAM角色的方式進行列舉,需要阿里雲帳號或帳號管理員通過RAM PolicyBucket 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如下: