調用PutResourcePoolBucketGroupQoSInfo配置或修改資源集區中BucketGroup的流控。
注意事項
當前資源集區QoS為邀測功能。您在某個地區的OSS效能達到500Gbps及以上，請聯絡支援人員申請使用。
阿里雲帳號預設擁有全部許可權。如果通過RAM使用者或者RAM角色的方式進行配置，需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予oss:PutResourcePoolBucketGroupQoSInfo許可權。
請求文法
PUT /?resourcePoolBucketGroupQosInfo&resourcePool=<ResourcePoolName>&resourcePoolBucketGroup=<ResourcePoolBucketGroupName>
Host: oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content length要求標頭
此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。
請求元素
以下頻寬配置項中，取值為-1（預設值）表示不限制頻寬。取值為0，表示禁止該類型的頻寬，例如ExtranetUploadBandwidth取值為0，表示禁止通過外網上傳資料到指定Bucket。
BucketGroup頻寬配置總和不能超過資源集區總的頻寬配置。BucketGroup單項頻寬配置不能超過總的頻寬配置。例如，總下載頻寬配置為10Gbps，則外網下載頻寬不能超過10Gbps。
BucketGroup單項頻寬配置不能低於5Gbps。
名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
resourcePool | 字串 | 是 | resource-pool-for-ai | 資源集區名稱。 |
resourcePoolBucketGroup | 字串 | 是 | test-group | BucketGroup名稱。 |
QoSConfiguration | 容器 | 是 | 不涉及 | 儲存流控配置資訊的容器。 父節點：無 |
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 |
回應標頭
此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。
樣本
請求樣本
PUT /?resourcePoolBucketGroupQosInfo&resourcePool=resource-pool-for-ai&resourcePoolBucketGroup=test-group Host: oss-cn-shanghai.aliyuncs.com Date: Sun, 11 Aug 2024 17:45:00 GMT Content-Type: application/xml Content-Length: content length Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e <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 Date: Sun, 11 Aug 2024 17:45:00 GMT Content-Length: 0
SDK
PutResourcePoolBucketGroupQoSInfo介面所對應的各語言SDK如下：