PutResourcePoolBucketGroupQoSInfo_对象存储(OSS)-阿里云帮助中心

调用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如下：