ListBucketRequesterQoSInfos - Object Storage Service

調用ListBucketRequesterQoSInfos擷取所有要求者在Bucket層級的流控配置。

注意事項

當前資源集區QoS為邀測功能。您在某個地區的OSS效能達到500Gbps及以上，請聯絡支援人員申請使用。
阿里雲帳號預設擁有擷取所有要求者在Bucket層級流控配置的許可權。如果您需要通過RAM使用者或者STS的方式進行擷取，您必須擁有oss:ListBucketRequesterQoSInfo許可權。具體操作，請參見RAM Policy常見樣本。

請求文法

GET /?requesterQosInfo&max-keys=10&continuation-token=207xxxx
Host: BucketName.oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

要求標頭

此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

請求元素

名稱	類型	是否必選	樣本值	描述
max-keys	字串	否	10	限定此次返回要求者流控資訊的最大條數。
continuation-token	字串	否	207xxxx	限定從哪個要求者開始返迴流控資訊。

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

響應元素

名稱	類型	樣本值	描述
ListBucketRequesterQoSInfosResult	容器	不涉及	儲存請求結果的容器。父節點：無
Bucket	字串	oss-example	返回要求者流控對應的Bucket名稱。父節點：ListBucketRequesterQoSInfosResult
ContinuationToken	字串	207xxxx	本次列舉請求使用的ContinuationToken。父節點：ListBucketRequesterQoSInfosResult
NextContinuationToken	字串	262xxxx	表明此次列舉請求包含後續結果，需要將NextContinuationToken指定為下次列舉請求的起點，繼續擷取結果。父節點：ListBucketRequesterQoSInfosResult
IsTruncated	布爾值	true	本次返回結果是否截斷。 true表示本次沒有返回全部結果。 false表示本次已經返回了全部結果。父節點：ListBucketRequesterQoSInfosResult
RequesterQoSInfo	容器	不涉及	儲存要求者流控配置資訊的容器。父節點：RequesterQoSInfo
Requester	字串	266xxxx	要求者UID。父節點：RequesterQoSInfo
QoSConfiguration	容器	不涉及	儲存要求者流控配置資訊的容器。父節點：RequesterQoSInfo
TotalUploadBandwidth	整數	10	要求者在Bucket層級的總上傳頻寬，單位Gbps。父節點：QoSConfiguration
IntranetUploadBandwidth	整數	-1	要求者在Bucket層級的內網上傳頻寬，包括傳統網路和VPC網路的內網上傳頻寬，單位Gbps。父節點：QoSConfiguration
ExtranetUploadBandwidth	整數	-1	要求者在Bucket層級的外網上傳頻寬，包括公網和傳輸加速網域名稱的上傳頻寬，單位Gbps。父節點：QoSConfiguration
TotalDownloadBandwidth	整數	10	要求者在Bucket層級的總下載頻寬，單位Gbps。父節點：QoSConfiguration
IntranetDownloadBandwidth	整數	-1	要求者在Bucket層級的內網下載頻寬，包括傳統網路和VPC網路的內網下載頻寬，單位Gbps。父節點：QoSConfiguration
ExtranetDownloadBandwidth	整數	-1	要求者在Bucket層級的外網下載頻寬，包括公網和傳輸加速網域名稱的上傳頻寬，單位Gbps。父節點：QoSConfiguration

樣本

請求樣本

GET /?requesterQosInfo&max-keys=2&continuation-token=207xxxx
Host: oss-example.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

返回樣本

HTTP/1.1 200 OK
Date: Fri, 27 Dec 2024 03:21:12 GMT
Content-Length: 1385
x-oss-request-id: 534****

<ListBucketRequesterQoSInfosResult>
  <Bucket>BucketName</Bucket>
  <ContinuationToken>207xxxx</ContinuationToken>
  <NextContinuationToken>262xxxx</NextContinuationToken>
  <IsTruncated>true</IsTruncated>
  <RequesterQoSInfo>
    <Requester>266xxxx</Requester>
    <QoSConfiguration>
      <TotalUploadBandwidth>10</TotalUploadBandwidth>
      <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
      <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
      <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
      <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
      <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
    </QoSConfiguration>
  </RequesterQoSInfo>
  <RequesterQoSInfo>
    <Requester>276xxxx</Requester>
    <QoSConfiguration>
      <TotalUploadBandwidth>10</TotalUploadBandwidth>
      <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
      <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
      <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
      <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
      <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
    </QoSConfiguration>
  </RequesterQoSInfo>
</ListBucketRequesterQoSInfosResult>

SDK

ListBucketRequesterQoSInfos介面所對應的各語言SDK如下：

命令列工具ossutil

ListBucketRequesterQoSInfos介面所對應的ossutil命令，請參見list-bucket-requester-qos-infos。