PutBucketRequesterQoSInfo - Object Storage Service

調用PutBucketRequesterQoSInfo佈建要求者在Bucket層級的流控。

注意事項

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

請求文法

PUT /?requesterQosInfo&qosRequester=uid
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

<QoSConfiguration>
  <TotalUploadBandwidth>10</TotalUploadBandwidth>
  <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
</QoSConfiguration>

要求標頭

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

請求元素

說明

以下頻寬配置項中，取值為-1（預設值）表示不限制頻寬。取值為0，表示禁止該類型的頻寬，例如ExtranetUploadBandwidth取值為0，表示禁止通過外網上傳資料到指定Bucket。
Bucket層級的要求者頻寬配置不能超過Bucket總的頻寬配置。例如，Bucket總下載頻寬配置為100Gbps，則Bucket的要求者外網下載頻寬不能超過100Gbps。
要求者各項頻寬節流設定不能低於5Gbps。

名稱	類型	是否必選	樣本值	描述
qosRequester	字串	是	300xxxx	要求者UID。父節點：無
QoSConfiguration	容器	是	不涉及	儲存結果的容器。父節點：無
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

回應標頭

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

樣本

請求樣本

PUT /?requesterQosInfo&qosRequester=300xxxx
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Length: 209
Date: Fri, 27 Dec 2024 03:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

<?xml version="1.0" encoding="UTF-8"?>
<QoSConfiguration>
  <TotalUploadBandwidth>10</TotalUploadBandwidth>
  <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
</QoSConfiguration>

返回樣本

HTTP/1.1 200 OK
x-oss-request-id: 534****
Date: Fri, 27 Dec 2024 03:21:12 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

SDK

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

命令列工具ossutil

PutBucketRequesterQoSInfo介面所對應的ossutil命令，請參見put-bucket-requester-qos-info。