Object Storage Service:Use resource pool QoS to guarantee bandwidth for critical services

Console

On the Resource Pool QoS page, click the name of the target resource pool. For the target bucket, click Modify Throttling Configuration on the right and set the bandwidth as required.

ossutil

Before you begin, install ossutil.

1. You can configure the bandwidth limit for a specific bucket using a local XML configuration file named qos.xml.

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

2. To add the preceding bandwidth configuration to a specific bucket, run the following command. In this example, the bucket is named examplebucket.

   ossutil api invoke-operation --op-name put-bucket-qos-info --method PUT --bucket examplebucket --parameters qosInfo --body=file://qos.xml

3. To view the bandwidth configuration of the bucket, run the following command.

   ossutil api invoke-operation --op-name get-bucket-qos-info --method GET --bucket examplebucket --parameters qosInfo

SDK

Currently, you can set a bandwidth limit for a bucket only using Python SDK V2 and Go SDK V2.

1. You can configure the bandwidth limit for the bucket using a local qos.xml file.

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

2. To set the preceding bandwidth configuration for a specific bucket, use the following code.

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutBucketQoSInfo():
      # Obtain access credentials from environment variables for authentication
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Load default configurations and obtain the configuration file.
       cfg = oss.config.load_default()
   
       # Specify the credential provider.
       cfg.credentials_provider = credentials_provider
   
       # Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Initialize the OSSClient instance by using the configuration file.
       client = oss.Client(cfg)
   
       # Set qos_xml_body to an empty string.
       qos_xml_body = ""
   
       # Open the file named qos.xml and read its content into the qos_xml_body variable.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Specify input parameters for the PutBucketQoSInfo operation to specify the QoS rules for the bucket.
       req = oss.OperationInput(
           op_name = 'PutBucketQoSInfo',  # Operation name, specifying the operation to set bucket QoS information
           method = 'PUT',  # The type of the HTTP method. In this example, PUT is used to update resources.
           parameters = {
               'qosInfo': '',  # The QoS-related parameters.
           },
           headers = None,  # The request headers. If you do not need to specify additional headers, leave the field empty.
           body = qos_xml_body,  # The request body, which contains the content read from the qos.xml file.
           bucket = 'examplebucket',  # The name of the bucket.
       )
   
       # Use the invoke_operation method of the client to run the request and obtain the response or error message.
       resp = client.invoke_operation(req)
   
       # Display the returned HTTP status code.
       print(resp.status_code)
   
       # Display the response headers.
       print(resp.headers)
   
   if __name__ == "__main__":
       GetBucketQoSInfo()

API

You can call the PutBucketQoSInfo operation to limit the bucket bandwidth, as shown in the following example.

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

Console

1. First, view the RAM user ID.

2. On the Resource Pool QoS page, click the name of the target resource pool. Then, click Configure Requester Throttling to the right of the target bucket. Set the required bandwidth for the RAM user to access the bucket.

ossutil

Before you begin, install ossutil.

The following example shows how to limit the bandwidth for a RAM user to access a bucket in a resource pool:

1. You can configure the bandwidth limit for a specific RAM user to access a bucket in the resource pool using a local XML configuration file named qos.xml.

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

2. View the RAM user ID.

3. To add the preceding bandwidth configuration for the RAM user (UID 266xxxx) who accesses the bucket, run the following command. In this example, the bucket is named examplebucket.

   ossutil api invoke-operation --op-name put-bucket-requester-qos-info --method PUT --bucket=examplebucket --parameters requesterQosInfo --parameters qosRequester=266xxxx --body file://qos.xml

4. (Optional) To retrieve the bandwidth configuration for the RAM user to access a bucket in the resource pool, run the following command.

   ossutil api invoke-operation --op-name get-bucket-requester-qos-info --method GET --bucket=examplebucket --parameters requesterQosInfo --parameters qosRequester=266xxxx

SDK

Currently, you can limit the bandwidth for a RAM user to access a bucket only using Python SDK V2 and Go SDK V2.

1. You can configure the bandwidth limit for a specific RAM user to access a bucket in the resource pool using a local qos.xml file.

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

2. View the RAM user ID.

3. Set the preceding bandwidth configuration for the RAM user who accesses the bucket.

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutBucketRequesterQoSInfo():
       # Obtain access credentials from environment variables for authentication.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Load default configurations and obtain the configuration file.
       cfg = oss.config.load_default()
   
       # Specify the credential provider.
       cfg.credentials_provider = credentials_provider
   
       # Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Initialize the OSSClient instance by using the configuration file.
       client = oss.Client(cfg)
   
       # Set qos_xml_body to an empty string.
       qos_xml_body = ""
   
       # Open a file named qos.xml and read its content into the qos_xml_body variable.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Specify input parameters for the PutBucketRequesterQoSInfo operation to configure throttling rules for a requester accessing a bucket.
       req = oss.OperationInput(
           op_name = 'PutBucketRequesterQoSInfo',  # The name of the operation.
           method = 'PUT',  # The type of the HTTP method. In this example, PUT is used.
           parameters = {
               'requesterQosInfo': '',  # The QoS-related parameters.
               'qosRequester': '2598732222222xxxx',  # The unique identifier for the requester, which is used to distinguish different requesters.
           },
           headers = None,  # The request headers. If you do not need to specify additional headers, leave the field empty.
           body = qos_xml_body,  # The request body, which contains the content read from the qos.xml file.
           bucket = 'examplebucket',  # The name of the bucket.
       )
   
       # Use the invoke_operation method of the client to execute the request and obtain the response.
       resp = client.invoke_operation(req)
   
       # Display the returned HTTP status code.
       print(resp.status_code)
   
       # Display the response headers.
       print(resp.headers)
   
       # Display the response body, which typically contains the specific data returned by the request.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketRequesterQoSInfo()

API

1. View the RAM user ID.

2. Call the PutBucketRequesterQoSInfo operation to limit the bandwidth for a RAM user to access a bucket, as shown in the following example.

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

Console

1. View the RAM role ID.

2. On the Resource Pool QoS page, click the name of the target resource pool. Then, click Configure Requester Throttling for the target bucket and set the required bandwidth.

ossutil

Before you begin, install ossutil.

1. You can configure the bandwidth limit for this role to access a specific bucket using a local XML configuration file named qos.xml.

   <QoSConfiguration>
     <TotalUploadBandwidth>100</TotalUploadBandwidth>
     <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
     <ExtranetUploadBandwidth>20</ExtranetUploadBandwidth>
     <TotalDownloadBandwidth>100</TotalDownloadBandwidth>
     <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
     <ExtranetDownloadBandwidth>40</ExtranetDownloadBandwidth>
   </QoSConfiguration>

2. View the RAM role ID.

3. To add the bandwidth configuration for this role (role ID 362xxxx) to access a specific bucket, run the following command. In this example, the bucket is named examplebucket.

   ossutil api invoke-operation --op-name put-bucket-requester-qos-info --method PUT --bucket=examplebucket --parameters requesterQosInfo --parameters qosRequester=362xxxx --body file://qos.xml

4. (Optional) To list the bandwidth configurations of all RAM roles in the resource pool, run the following command.

   ossutil api invoke-operation --op-name list-resource-pool-requester-qos-infos --method GET --parameters resourcePool=examplePool  --parameters requesterQosInfo

SDK

Currently, you can limit the bandwidth for a RAM role to access a bucket only using Python SDK V2 and Go SDK V2.

1. You can configure the bandwidth limit for a specific RAM user to access a bucket in the resource pool using a local qos.xml file.

   <QoSConfiguration>
     <TotalUploadBandwidth>100</TotalUploadBandwidth>
     <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
     <ExtranetUploadBandwidth>20</ExtranetUploadBandwidth>
     <TotalDownloadBandwidth>100</TotalDownloadBandwidth>
     <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
     <ExtranetDownloadBandwidth>40</ExtranetDownloadBandwidth>
   </QoSConfiguration>

2. View the RAM role ID.

3. Set the preceding bandwidth configuration for the RAM role.

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutBucketRequesterQoSInfo():
       # Obtain access credentials from environment variables for authentication.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Load default configurations and obtain the configuration file.
       cfg = oss.config.load_default()
   
       # Specify the credential provider.
       cfg.credentials_provider = credentials_provider
   
       # Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Initialize the OSSClient instance by using the configuration file.
       client = oss.Client(cfg)
   
       # Set qos_xml_body to an empty string.
       qos_xml_body = ""
   
       # Open a file named qos.xml and read its content into the qos_xml_body variable.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Specify input parameters for the PutBucketRequesterQoSInfo operation to configure throttling rules for a requester accessing a bucket.
       req = oss.OperationInput(
           op_name = 'PutBucketRequesterQoSInfo',  # The name of the operation.
           method = 'PUT',  # The type of the HTTP method. In this example, PUT is used.
           parameters = {
               'requesterQosInfo': '',  # The QoS-related parameters.
               'qosRequester': '2598732222222xxxx',  # The unique identifier for the requester, which is used to distinguish different requesters.
           },
           headers = None,  # The request headers. If you do not need to specify additional headers, leave the field empty.
           body = qos_xml_body,  # The request body, which contains the content read from the qos.xml file.
           bucket = 'examplebucket',  # The name of the bucket.
       )
   
       # Use the invoke_operation method of the client to execute the request and obtain the response.
       resp = client.invoke_operation(req)
   
       # Display the returned HTTP status code.
       print(resp.status_code)
   
       # Display the response headers.
       print(resp.headers)
   
       # Display the response body, which typically contains the specific data returned by the request.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketRequesterQoSInfo()

API

1. View the RAM role ID.

2. Call the PutBucketRequesterQoSInfo operation to limit the bandwidth for a RAM role to access a bucket, as shown in the following example.

   <QoSConfiguration>
     <TotalUploadBandwidth>100</TotalUploadBandwidth>
     <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
     <ExtranetUploadBandwidth>20</ExtranetUploadBandwidth>
     <TotalDownloadBandwidth>100</TotalDownloadBandwidth>
     <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
     <ExtranetDownloadBandwidth>40</ExtranetDownloadBandwidth>
   </QoSConfiguration>

Console

1. On the Resource Pool QoS page, click the name of the target resource pool. Then, click Create BucketGroup, enter a name for the BucketGroup, and set the required bandwidth.

2. On the target resource pool page, click Configure BucketGroup to the right of the target bucket to add the low-priority bucket to the group.

ossutil

Before you begin, install ossutil.

1. To add the scheduled-posts and archived-comments buckets to a BucketGroup:

   1. To add the scheduled-posts bucket to the BucketGroup, run the following command.

      ossutil api invoke-operation --op-name put-bucket-resource-pool-bucket-group --method PUT --bucket scheduled-posts --parameters resourcePool=pool-for-ai --parameters resourcePoolBucketGroup=test-group

   2. To add the archived-comments bucket to the BucketGroup, run the following command.

      ossutil api invoke-operation --op-name put-bucket-resource-pool-bucket-group --method PUT --bucket archived-comments --parameters resourcePool=pool-for-ai --parameters resourcePoolBucketGroup=test-group

   3. (Optional) To retrieve the list of buckets added to the BucketGroup, run the following command.

      ossutil api invoke-operation --op-name list-resource-pool-bucket-groups --method GET --parameters resourcePool=pool-for-ai --parameters resourcePoolBucketGroup

2. You can configure the bandwidth limit for a specific BucketGroup in the resource pool using a local XML configuration file named qos.xml.

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

3. To configure the bandwidth for the BucketGroup, run the following command.

   ossutil api invoke-operation --op-name put-resource-pool-bucket-group-qos-info --method PUT --parameters resourcePoolBucketGroupQosInfo --parameters resourcePool pool-for-ai --parameters resourcePoolBucketGroup offline-group --body=file://qos.xml

4. (Optional) To retrieve the bandwidth configuration of the BucketGroup, run the following command.

   ossutil api invoke-operation --op-name get-resource-pool-bucket-group-qos-info --method GET --parameters resourcePool=pool-for-ai --parameters resourcePoolBucketGroup=offline-group --parameters resourcePoolBucketGroupQoSInfo

SDK

Currently, you can limit the bandwidth of a BucketGroup only using Python SDK V2 and Go SDK V2.

1. Add two buckets from the resource pool to a BucketGroup.

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutBucketResourcePoolBucketGroup():
       # Obtain access credentials from environment variables for authentication.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Load default configurations and obtain the configuration file.
       cfg = oss.config.load_default()
   
       # Specify the credential provider.
       cfg.credentials_provider = credentials_provider
   
       # Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Initialize the OSSClient instance by using the configuration file.
       client = oss.Client(cfg)
   
       # Specify input parameters for the PutBucketResourcePoolBucketGroup operation.
       req = oss.OperationInput(
           op_name = 'PutBucketResourcePoolBucketGroup',  # The name of the operation.
           method = 'PUT',  # The type of the HTTP method type. In this example, PUT is used.
           parameters = {
               'resourcePoolBucketGroup': 'example-group',  # The name of the bucket group in the resource pool.
               'resourcePool': 'example-resource-pool',               # The name of the resource pool.
           },
           headers = None,  # The request headers. If you do not need to specify additional headers, leave the field empty.
           body = None,  # The request body, which is typically not required for PUT requests.
           bucket = 'examplebucket',  # The name of the bucket.
       )
   
       # Use the invoke_operation method of the client to execute the request and obtain the response.
       resp = client.invoke_operation(req)
   
       # Display the returned HTTP status code.
       print(resp.status_code)
   
       # Display the response headers.
       print(resp.headers)
   
       # Display the response body, which typically contains the specific data returned by the request.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketResourcePoolBucketGroup()

2. You can configure the bandwidth limit for a specific BucketGroup in the resource pool using a local XML configuration file named qos.xml.

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

3. Configure the bandwidth for the BucketGroup.

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutResourcePoolBucketGroupQoSInfo():
       # Obtain access credentials from environment variables for authentication.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Load default configurations and obtain the configuration file.
       cfg = oss.config.load_default()
   
       # Specify the credential provider.
       cfg.credentials_provider = credentials_provider
   
       # Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Initialize the OSSClient instance by using the configuration file.
       client = oss.Client(cfg)
   
       # Set qos_xml_body to an empty string.
       qos_xml_body = ""
   
       # Open and read the qos.xml file and write its content into the qos_xml_body variable.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Specify input parameters for the PutResourcePoolBucketGroupQoSInfo operation.
       req = oss.OperationInput(
           op_name = 'PutResourcePoolBucketGroupQoSInfo',  # The name of the operation.
           method = 'PUT',  # The type of the HTTP method type. In this example, PUT is used.
           parameters = {
               'resourcePoolBucketGroupQosInfo': '',  # The QoS-related parameters.
               'resourcePool': 'example-resource-pool',           #  The name of the resource pool
               'resourcePoolBucketGroup': 'example-group',  # The name of the bucket group.
           },
           headers = None,  # The request headers. If you do not need to specify additional headers, leave the field empty.
           body = qos_xml_body,  # The request body, which contains the content read from the qos.xml file.
           bucket = None,  # The name of the bucket, which is not required for PUT requests. This operation is not performed on a specific bucket.
       )
   
       # Use the invoke_operation method of the client to execute the request and obtain the response.
       resp = client.invoke_operation(req)
   
       # Display the returned HTTP status code.
       print(resp.status_code)
   
       # Display the response headers.
       print(resp.headers)
   
       # Display the response body, which typically contains the specific data returned by the request.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutResourcePoolBucketGroupQoSInfo()

API

Call the PutResourcePoolBucketGroupQoSInfo operation to limit the bandwidth of a BucketGroup, as shown in the following example.

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

Console

1. View the RAM user ID or RAM role ID.

2. On the Resource Pool QoS page, click the name of the target resource pool. On the Resource Pool Requester List tab, click Modify Throttling Configuration for the target RAM user or RAM role to set the bandwidth for the resource pool requester.

ossutil

Before you begin, install ossutil.

1. You can configure the bandwidth limit for a RAM user or RAM role to access the resource pool using a local XML configuration file named qos.xml.

   <QoSConfiguration>
     <TotalUploadBandwidth>100</TotalUploadBandwidth>
     <IntranetUploadBandwidth>50</IntranetUploadBandwidth>
     <ExtranetUploadBandwidth>50</ExtranetUploadBandwidth>
     <TotalDownloadBandwidth>200</TotalDownloadBandwidth>
     <IntranetDownloadBandwidth>150</IntranetDownloadBandwidth>
     <ExtranetDownloadBandwidth>50</ExtranetDownloadBandwidth>
   </QoSConfiguration>

2. View the RAM user ID or RAM role ID.

3. To add the preceding bandwidth configuration for the RAM user (UID 266xxxx), run the following command.

   ossutil api invoke-operation --op-name put-resource-pool-requester-qos-info --method PUT --parameters resourcePool=examplepool --parameters qosRequester=266xxxx --parameters requesterQosInfo --body=file://qos.xml

4. (Optional) To list the bandwidth configurations of all RAM users in the resource pool, run the following command.

   ossutil api invoke-operation --op-name list-resource-pool-requester-qos-infos --method GET --parameters resourcePool=examplePool  --parameters requesterQosInfo

SDK

Currently, you can limit the bandwidth for a RAM user or RAM role to access a resource pool only using Python SDK V2 and Go SDK V2.

1. You can configure the bandwidth limit for a specific RAM user or RAM role to access the resource pool using a local qos.xml file.

   <QoSConfiguration>
     <TotalUploadBandwidth>100</TotalUploadBandwidth>
     <IntranetUploadBandwidth>50</IntranetUploadBandwidth>
     <ExtranetUploadBandwidth>50</ExtranetUploadBandwidth>
     <TotalDownloadBandwidth>200</TotalDownloadBandwidth>
     <IntranetDownloadBandwidth>150</IntranetDownloadBandwidth>
     <ExtranetDownloadBandwidth>50</ExtranetDownloadBandwidth>
   </QoSConfiguration>

2. View the RAM user ID or RAM role ID.

3. Set the preceding bandwidth configuration for the RAM user or RAM role.

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutResourcePoolRequesterQoSInfo():
       # Obtain access credentials from environment variables for authentication.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Load default configurations and obtain the configuration file.
       cfg = oss.config.load_default()
   
       # Specify the credential provider.
       cfg.credentials_provider = credentials_provider
   
       # Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Initialize the OSSClient instance by using the configuration file.
       client = oss.Client(cfg)
   
       # Initialize qos_xml_body as an empty string
       qos_xml_body = ""
   
       # Open a file named qos.xml and read its content into the qos_xml_body variable.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Specify input parameters for the PutResourcePoolRequesterQoSInfo operation.
       req = oss.OperationInput(
           op_name = 'PutResourcePoolRequesterQoSInfo',  # The name of the operation.
           method = 'PUT',  # The type of the HTTP method type. In this example, PUT is used.
           parameters = {
               'requesterQosInfo': '',  # The QoS-related parameters.
               'resourcePool': 'example-resource-pool',  # The name of the resource pool.
               'qosRequester': '2598732222222xxxx',  # The ID of the requester.
           },
           headers = None,  # The request headers. If you do not need to specify additional headers, leave the field empty.
           body = qos_xml_body,  # The request body, which contains the content read from the qos.xml file.
           bucket = None,  # The name of the bucket, which is not required for PUT requests. The operation is not performed on a specific bucket.
       )
   
       # Use the invoke_operation method of the client to execute the request and obtain the response.
       resp = client.invoke_operation(req)
   
       # Display the returned HTTP status code.
       print(resp.status_code)
   
       # Display the response headers.
       print(resp.headers)
   
       # Display the response body, which typically contains the specific data returned by the request.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutResourcePoolRequesterQoSInfo()

API

1. View the RAM user ID or RAM role ID.

2. Call the PutResourcePoolRequesterQoSInfo operation to limit the bandwidth for a RAM user or RAM role to access the resource pool, as shown in the following example.

   <QoSConfiguration>
     <TotalUploadBandwidth>100</TotalUploadBandwidth>
     <IntranetUploadBandwidth>50</IntranetUploadBandwidth>
     <ExtranetUploadBandwidth>50</ExtranetUploadBandwidth>
     <TotalDownloadBandwidth>200</TotalDownloadBandwidth>
     <IntranetDownloadBandwidth>150</IntranetDownloadBandwidth>
     <ExtranetDownloadBandwidth>50</ExtranetDownloadBandwidth>
   </QoSConfiguration>

ossutil

1. First, create a priority configuration file named priority-qos.xml.

   <PriorityQosConfiguration>
     <PriorityCount>3</PriorityCount>
     <DefaultPriorityLevel>1</DefaultPriorityLevel>
     
     <DefaultGuaranteedQosConfiguration>
       <TotalUploadBandwidth>10</TotalUploadBandwidth>
       <IntranetUploadBandwidth>5</IntranetUploadBandwidth>
       <ExtranetUploadBandwidth>5</ExtranetUploadBandwidth>
       <TotalDownloadBandwidth>20</TotalDownloadBandwidth>
       <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
       <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
     </DefaultGuaranteedQosConfiguration>
     
     <QosPriorityLevelConfiguration>
       <PriorityLevel>3</PriorityLevel>
       <GuaranteedQosConfiguration>
         <TotalUploadBandwidth>50</TotalUploadBandwidth>
         <TotalDownloadBandwidth>80</TotalDownloadBandwidth>
         <ExtranetUploadBandwidth>30</ExtranetUploadBandwidth>
         <IntranetUploadBandwidth>20</IntranetUploadBandwidth>
         <ExtranetDownloadBandwidth>50</ExtranetDownloadBandwidth>
         <IntranetDownloadBandwidth>30</IntranetDownloadBandwidth>
       </GuaranteedQosConfiguration>
       <Subjects>
         <Bucket>critical-bucket</Bucket>
         <BucketGroup>core-group</BucketGroup>
       </Subjects>
     </QosPriorityLevelConfiguration>
     
     <QosPriorityLevelConfiguration>
       <PriorityLevel>2</PriorityLevel>
       <GuaranteedQosConfiguration>
         <TotalUploadBandwidth>30</TotalUploadBandwidth>
         <TotalDownloadBandwidth>50</TotalDownloadBandwidth>
         <ExtranetUploadBandwidth>20</ExtranetUploadBandwidth>
         <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
         <ExtranetDownloadBandwidth>30</ExtranetDownloadBandwidth>
         <IntranetDownloadBandwidth>20</IntranetDownloadBandwidth>
       </GuaranteedQosConfiguration>
       <Subjects>
         <Bucket>important-bucket</Bucket>
       </Subjects>
     </QosPriorityLevelConfiguration>
   </PriorityQosConfiguration>

2. Application configuration

   ossutil api invoke-operation --op-name put-resource-pool-priority-qos-configuration --method PUT --parameters resourcePool=hz-rp-03 --parameters priorityQos --body=file://priority-qos.xml

3. You can retrieve and verify the configuration.

   ossutil api invoke-operation --op-name get-resource-pool-priority-qos-configuration --method GET --parameters resourcePool=hz-rp-03 --parameters priorityQos

SDK

package main

import (
	"bytes"
	"context"
	"crypto/md5"
	"encoding/base64"
	"fmt"
	"os"

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

func PutResourcePoolPriorityQosConfiguration() {
	// Specify the region where the bucket is located. For example, set the region to cn-hangzhou for China (Hangzhou).
	var region = "cn-hangzhou"

	// Load the default configurations and set the credential provider and region.
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	// Create an OSS client.
	client := oss.NewClient(cfg)

	// Define the resource pool name.
	resourcePool := "hz-rp-01"

	// Read the content of the priority QoS configuration file.
	qosConf, err := os.ReadFile("priority-qos.xml")
	if err != nil {
		// If an error occurs when reading the QoS configuration file, print the error message and exit the program.
		fmt.Printf("failed to read qos.xml: %v\n", err)
		os.Exit(1)
	}

	// Calculate the MD5 hash of the input data and convert it to a Base64-encoded string.
	calcMd5 := func(input []byte) string {
		if len(input) == 0 {
			return "1B2M2Y8AsgTpgAmY7PhCfg=="
		}
		h := md5.New()
		h.Write(input)
		return base64.StdEncoding.EncodeToString(h.Sum(nil))
	}

	// Create the input parameters for the operation, including the action, method type, and parameters.
	input := &oss.OperationInput{
		OpName: "PutResourcePoolPriorityQoSConfiguration", // Action
		Method: "PUT",                                     // HTTP method
		Parameters: map[string]string{
			"priorityQos":  "",           // Priority QoS-related parameters.
			"resourcePool": resourcePool, // Resource pool name
		},
		Headers: map[string]string{
			"Content-MD5": calcMd5(qosConf), // Set the Content-MD5 header for the request body to ensure data integrity.
		},
		Body:   bytes.NewReader(qosConf), // Request body that contains the QoS configuration.
		Bucket: nil,                      // This operation does not target a specific bucket.
	}

	// Execute the operation and receive the response or an error.
	res, err := client.InvokeOperation(context.TODO(), input)
	if err != nil {
		// If an error occurs, print the error message and exit the program.
		fmt.Printf("invoke operation got error: %v\n", err)
		os.Exit(1)
	}

	// Print the operation result.
	fmt.Println("The result of PutResourcePoolPriorityQoSConfiguration:", res.Status)
}

API

PutResourcePoolPriorityQosConfiguration

ossutil

1. First, create a requester priority configuration file named requester-priority-qos.xml.

   <PriorityQosConfiguration>
     <PriorityCount>3</PriorityCount>
     <DefaultPriorityLevel>1</DefaultPriorityLevel>
     
     <DefaultGuaranteedQosConfiguration>
       <TotalUploadBandwidth>10</TotalUploadBandwidth>
       <IntranetUploadBandwidth>5</IntranetUploadBandwidth>
       <ExtranetUploadBandwidth>5</ExtranetUploadBandwidth>
       <TotalDownloadBandwidth>20</TotalDownloadBandwidth>
       <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
       <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
     </DefaultGuaranteedQosConfiguration>
     
     <QosPriorityLevelConfiguration>
       <PriorityLevel>3</PriorityLevel>
       <GuaranteedQosConfiguration>
         <TotalUploadBandwidth>60</TotalUploadBandwidth>
         <TotalDownloadBandwidth>100</TotalDownloadBandwidth>
         <ExtranetUploadBandwidth>40</ExtranetUploadBandwidth>
         <IntranetUploadBandwidth>20</IntranetUploadBandwidth>
         <ExtranetDownloadBandwidth>60</ExtranetDownloadBandwidth>
         <IntranetDownloadBandwidth>40</IntranetDownloadBandwidth>
       </GuaranteedQosConfiguration>
       <Subjects>
         <Requester>123456789012****</Requester>
         <Requester>234567890123****</Requester>
       </Subjects>
     </QosPriorityLevelConfiguration>
     
     <QosPriorityLevelConfiguration>
       <PriorityLevel>2</PriorityLevel>
       <GuaranteedQosConfiguration>
         <TotalUploadBandwidth>30</TotalUploadBandwidth>
         <TotalDownloadBandwidth>50</TotalDownloadBandwidth>
         <ExtranetUploadBandwidth>20</ExtranetUploadBandwidth>
         <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
         <ExtranetDownloadBandwidth>30</ExtranetDownloadBandwidth>
         <IntranetDownloadBandwidth>20</IntranetDownloadBandwidth>
       </GuaranteedQosConfiguration>
       <Subjects>
         <Requester>345678901234****</Requester>
       </Subjects>
     </QosPriorityLevelConfiguration>
   </PriorityQosConfiguration>

2. Application Configuration

   ossutil api invoke-operation --op-name put-resource-pool-requester-priority-qos-configuration --method PUT --parameters resourcePool=hz-rp-03 --parameters requesterPriorityQos --body=file://requester-priority-qos.xml

3. (Optional) To retrieve and verify the configuration, run the following command.

   ossutil api invoke-operation --op-name get-resource-pool-requester-priority-qos-configuration --method GET --parameters resourcePool=hz-rp-03 --parameters requesterPriorityQos

SDK

package main

import (
	"bytes"
	"context"
	"crypto/md5"
	"encoding/base64"
	"fmt"
	"os"

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

func PutResourcePoolRequesterPriorityQosConfiguration() {
	// Specify the region where the bucket is located. For example, set the region to cn-hangzhou for China (Hangzhou).
	var region = "cn-hangzhou"

	// Load the default configurations and set the credential provider and region.
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	// Create an OSS client.
	client := oss.NewClient(cfg)

	// Define the resource pool name.
	resourcePool := "hz-rp-01"

	// Read the content of the requester priority QoS configuration file.
	qosConf, err := os.ReadFile("requester-priority-qos.xml")
	if err != nil {
		// If an error occurs when reading the QoS configuration file, print the error message and exit the program.
		fmt.Printf("failed to read qos.xml: %v\n", err)
		os.Exit(1)
	}

	// Calculate the MD5 hash of the input data and convert it to a Base64-encoded string.
	calcMd5 := func(input []byte) string {
		if len(input) == 0 {
			return "1B2M2Y8AsgTpgAmY7PhCfg=="
		}
		h := md5.New()
		h.Write(input)
		return base64.StdEncoding.EncodeToString(h.Sum(nil))
	}

	// Create the input parameters for the operation, including the action, method type, and parameters.
	input := &oss.OperationInput{
		OpName: "PutResourcePoolRequesterPriorityQoSConfiguration", // Action
		Method: "PUT",                                              // HTTP method
		Parameters: map[string]string{
			"requesterPriorityQos": "", // Requester priority QoS-related parameters.
			"resourcePool":         resourcePool, // Resource pool name
		},
		Headers: map[string]string{
			"Content-MD5": calcMd5(qosConf), // Set the Content-MD5 header for the request body to ensure data integrity.
		},
		Body:   bytes.NewReader(qosConf), // Request body that contains the QoS configuration.
		Bucket: nil,                      // This operation does not target a specific bucket.
	}

	// Execute the operation and receive the response or an error.
	res, err := client.InvokeOperation(context.TODO(), input)
	if err != nil {
		// If an error occurs, print the error message and exit the program.
		fmt.Printf("invoke operation got error: %v\n", err)
		os.Exit(1)
	}

	// Print the operation result.
	fmt.Println("The result of PutResourcePoolRequesterPriorityQoSConfiguration:", res.Status)
}

API

PutResourcePoolRequesterPriorityQosConfiguration