Configures or modifies the Quality of Service (QoS) for a bucket group in a resource pool.
Precautions
-
Resource pool QoS is in invitational preview. If the throughput of your OSS buckets in a region has reached or exceeded 500 Gbit/s, you can contact technical support to apply for this feature.
-
By default, an Alibaba Cloud account has all permissions. If you use a Resource Access Management (RAM) user or RAM role, the account owner or an administrator must grant the oss:PutResourcePoolBucketGroupQoSInfo permission by using a RAM policy or a bucket policy.
Request syntax
PUT /?resourcePoolBucketGroupQosInfo&resourcePool=<ResourcePoolName>&resourcePoolBucketGroup=<ResourcePoolBucketGroupName>
Host: oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content lengthRequest headers
This operation uses only common request headers. For more information, see Common Request Headers.
Request elements
-
For the bandwidth configuration items, a value of -1 is the default and indicates no limit. A value of 0 disables the corresponding bandwidth type. For example, if you set ExtranetUploadBandwidth to 0, you cannot upload data to the bucket from the public network.
-
The total bandwidth for the bucket group cannot exceed the total bandwidth of the resource pool. The value for a specific bandwidth type cannot exceed the total value for that bandwidth type. For example, if `TotalDownloadBandwidth` is set to 10 Gbps, `ExtranetDownloadBandwidth` cannot be greater than 10 Gbps.
-
If you set a specific bandwidth limit, the value must be 5 Gbps or higher.
|
Name |
Type |
Required |
Example |
Description |
|
resourcePool |
string |
Yes |
resource-pool-for-ai |
The name of the resource pool. |
|
resourcePoolBucketGroup |
string |
Yes |
test-group |
The name of the BucketGroup. |
|
QoSConfiguration |
container |
Yes |
Not applicable |
The container for the throttling configuration. Parent node: None |
|
TotalUploadBandwidth |
Integer |
Yes |
10 |
The total upload bandwidth for the BucketGroup. Unit: Gbps. Parent node: QoSConfiguration |
|
IntranetUploadBandwidth |
Integer |
Yes |
-1 |
The internal network upload bandwidth for the BucketGroup. This includes upload bandwidth for classic networks and VPCs. Unit: Gbps. Parent node: QoSConfiguration |
|
ExtranetUploadBandwidth |
Integer |
Yes |
-1 |
The public network upload bandwidth for the BucketGroup. This includes upload bandwidth for the Internet and acceleration endpoints. Unit: Gbps. Parent node: QoSConfiguration |
|
TotalDownloadBandwidth |
Integer |
Yes |
10 |
The total download bandwidth for the BucketGroup. Unit: Gbps. Parent node: QoSConfiguration |
|
IntranetDownloadBandwidth |
Integer |
Yes |
-1 |
The internal network download bandwidth for the BucketGroup. This includes download bandwidth for classic networks and VPCs. Unit: Gbps. Parent node: QoSConfiguration |
|
ExtranetDownloadBandwidth |
Integer |
Yes |
-1 |
The public network download bandwidth for the BucketGroup. This includes download bandwidth for the Internet and acceleration endpoints. Unit: Gbps. Parent node: QoSConfiguration |
Response headers
This operation uses only common response headers. For more information, see Common Response Headers.
Examples
-
Sample request
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> -
Sample response
HTTP/1.1 200 OK Date: Sun, 11 Aug 2024 17:45:00 GMT Content-Length: 0
SDK
The following SDKs support this operation: