This topic outlines how to use QoS policies for various business needs.

Use cases

The following use cases cover different scenarios. Choose the one that best fits your needs.

Use case	Description
Setting different throttling limits for various services accessing the same TOS resources	Where multiple services (e.g., vePFS and EMR) access the same TOS resources, use QoS policies to throttle the bandwidth for the IAM roles corresponding to each service. This ensures that the traffic behaviour of one service does not affect the others, as each service operates independently with dedicated traffic quotas.
Applying throttling at the workload level	Where multiple workloads (e.g., from vePFS or an IAM user) access different TOS resources, use QoS policies to throttle the bandwidth for each workload. This ensures that the traffic behaviour of one workload does not affect the others, as each workload operates independently with dedicated traffic quotas.
Throttling bandwidth for a specific bucket	Use a QoS policy to limit the upload bandwidth for a specific bucket, thereby preventing traffic spikes for that bucket from affecting other buckets.
Throttling bandwidth for a specific user	Use a QoS policy to limit the bandwidth of a user accessing TOS, thereby preventing them from consuming excessive bandwidth.
Prioritizing bandwidth for a specific bucket	Use a QoS policy to prioritize bandwidth for one bucket while limiting bandwidth for other buckets.
Prioritizing bandwidth for a specific user	Use a QoS policy to prioritize bandwidth for one user while limiting bandwidth for other users.
Implementing priority‑based throttling for various services accessing the same TOS resources	Where multiple services (e.g., vePFS and EMR) access the same TOS resources, use QoS policies to allocate guaranteed bandwidth and priorities to the corresponding IAM roles for each service. This maximizes resource utilization and achieves business stability.
Implementing priority‑based throttling across multiple buckets	For multi-bucket scenarios, use QoS policies to set the guaranteed bandwidth and priorities for each bucket and the IAM roles associated with your services accessing that bucket. This maximizes resource utilization and achieves business stability.

Setting different throttling limits for various services accessing the same TOS resources

In this section, we will set the write bandwidth limits for the 'bucketevent' bucket to 3,000 and 2,000 Mbps for vePFS and EMR, respectively.

Step 1: Throttle the bandwidth for vePFS

Log in to the TOS console.

In the left navigation pane, select Flow control management > QoS policy management.

On the QoS policy management page, set Region to China (Beijing) in the upper-left corner.

Configure the policy using your preferred view.

Visual view
JSON view
Configure QoS policies by visual view:
Click Create policy.
On the Create QoS policy page, set the following parameters.
Policy configuration method: Select Visual view.
Policy name: Enter a name for the policy. In this example, enter test.
Policy Type: Select Threshold traffic control.
QoS value: Set Category to WritesRate, and Value to 3,000.
Authorized user: Set Authorized user to Specified account and select Current main account. In the Role name section, click Add row to apply ServiceRoleForVEPFS.
User Policy: Select Include the above users.
Resource: Check the Objects in bucket checkbox. Set Bucket name to bucketevent and Scope of application to All objects.
Resource strategy: Select Include the above resources.
Condition: No conditions are required for this scenario.
After completing the settings, click Next step.
After verifying the details, click Confirm.
On the JSON view tab, click Edit. Then, copy the following content into the Statement, and click Save.

{
"Sid": "test",
"Quota": {
"WritesQps": "",
"ReadsQps": "",
"ListQps": "",
"WritesRate": "3000",
"ReadsRate": ""
},
"Principal": [
"trn:iam::214748****:role/ServiceRoleForVEPFS"
],
"Resource": "trn:tos:::bucketevent/*"
}

Step 2: Throttle the bandwidth for EMR

Log in to the TOS console.

In the left navigation pane, select Flow control management > QoS policy management.

On the QoS policy management page, set Region to China (Beijing) in the upper-left corner.

Configure the policy using your preferred view.

Visual view
JSON view
Configure QoS policies by visual view:
Click Create policy.
On the Create QoS policy page, set the following parameters.
Policy configuration method: Select Visual view.
Policy name: Enter a name for the policy. In this example, enter test2.
Policy Type: Select Threshold traffic control.
QoS value: Set Category to WritesRate, and Value to 2,000.
Authorized user: Set Authorized user to Specified account and select Current main account. In the Role name section, click Add row to apply ServiceRoleForEMROLAP.
User Policy: Select Include the above users.
Resource: Check the Objects in bucket checkbox. Set Bucket name to bucketevent and Scope of application to All objects.
Resource strategy: Select Include the above resources.
Condition: No conditions are required for this scenario.
After completing the settings, click Next step.
After verifying the details, click Confirm.
On the JSON view tab, click Edit. Then, copy the following content into the Statement, and click Save.
warning
In JSON, elements are separated by commas (,). Before copying new content into the Statement, add a comma (,) after the QoS rules for vePFS.

{
"Sid": "test2",
"Quota": {
"WritesQps": "",
"ReadsQps": "",
"ListQps": "",
"WritesRate": "2000",
"ReadsRate": ""
},
"Principal": [
"trn:iam::214748****:role/ServiceRoleForEMROLAP"
],
"Resource": "trn:tos:::bucketevent/*"
}

Applying throttling at the workload level

In this section, we will use vePFS and the IAM user "aaa" as examples. We will set the write bandwidth limit to 5,000 Mbps for vePFS when accessing the "bucketevent1" bucket, and the write bandwidth limit to 3,000 Mbps for aaa when accessing the "bucketevent2" bucket.

Step 1: Throttle the bandwidth for vePFS

Log in to the TOS console.

In the left navigation pane, select Flow control management > QoS policy management.

On the QoS policy management page, set Region to China (Beijing) in the upper-left corner.

Configure the policy using your preferred view.

Visual view
JSON view
Configure QoS policies by visual view:
Click Create policy.
On the Create QoS policy page, set the following parameters.
Policy configuration method: Select Visual view.
Policy name: Enter a name for the policy. In this example, enter test.
Policy Type: Select Threshold traffic control.
QoS value: Set Category to WritesRate, and Value to 5,000.
Authorized user: Set Authorized user to Specified account and select Current main account. In the Role name section, click Add row to apply ServiceRoleForVEPFS.
User Policy: Select Include the above users.
Resource: Check the Objects in bucket checkbox. Set Bucket name to bucketevent1 and Scope of application to All objects.
Resource strategy: Select Include the above resources.
Condition: No conditions are required for this scenario.
After completing the settings, click Next step.
After verifying the details, click Confirm.
On the JSON view tab, click Edit. Then, copy the following content into the Statement, and click Save.

{
"Sid": "test",
"Quota": {
"WritesQps": "",
"ReadsQps": "",
"ListQps": "",
"WritesRate": "5000",
"ReadsRate": ""
},
"Principal": [
"trn:iam::214748****:role/ServiceRoleForVEPFS"
],
"Resource": "trn:tos:::bucketevent1/*"
}

Step 2: Throttle the bandwidth for the specified user

Log in to the TOS console.

In the left navigation pane, select Flow control management > QoS policy management.

On the QoS policy management page, set Region to China (Beijing) in the upper-left corner.

Configure the policy using your preferred view.

Visual view
JSON view
Configure QoS policies by visual view:
Click Create policy.
On the Create QoS policy page, set the following parameters.
Policy configuration method: Select Visual view.
Policy name: Enter a name for the policy. In this example, enter test2.
Policy Type: Select Threshold traffic control.
QoS value: Set Category to WritesRate, and Value to 2,000.
Authorized user: Set Authorized user to Specified account and select Current main account. In the Sub account name section, click Add row and select aaa from the list.
User Policy: Select Include the above users.
Resource: Check the Objects in bucket checkbox. Set Bucket name to bucketevent2 and Scope of application to All objects.
Resource strategy: Select Include the above resources.
Condition: No conditions are required for this scenario.
After completing the settings, click Next step.
After verifying the details, click Confirm.
On the JSON view tab, click Edit. Then, copy the following content into the Statement, and click Save.
warning
In JSON, elements are separated by commas (,). Before copying new content into the Statement, add a comma (,) after the QoS rules for vePFS.

{
"Sid": "test2",
"Quota": {
"WritesQps": "",
"ReadsQps": "",
"ListQps": "",
"WritesRate": "2000",
"ReadsRate": ""
},
"Principal": [
"trn:iam::214748****:user/aaa"
],
"Resource": "trn:tos:::bucketevent2/*"
}

Throttling bandwidth for a specific bucket

In this section, we will use the 'bucketevent' bucket in China (Beijing) as an example. The default write bandwidth limit for this region is 10,000 Mbps, but we will limit this bucket's write bandwidth to 3,000 Mbps.

Log in to the TOS console.

In the left navigation pane, select Flow control management > QoS policy management.

On the QoS policy management page, set Region to China (Beijing) in the upper-left corner.

Configure the policy using your preferred view.

Visual view
JSON view
Configure QoS policies by visual view:
Click Create policy.
On the Create QoS policy page, set the following parameters.
Policy configuration method: Select Visual view.
Policy name: Enter a name for the policy. In this example, enter test3.
Policy Type: Select Threshold traffic control.
QoS value: Set Category to WritesRate, and Value to 3,000.
Authorized user: Select All users.
User Policy: Select Include the above users.
Resource: Check the Objects in bucket checkbox. Set Bucket name to bucketevent and Scope of application to All objects.
Resource strategy: Select Include the above resources.
Condition: No conditions are required for this scenario.
After completing the settings, click Next step.
After verifying the details, click Confirm.
On the JSON view tab, click Edit. Then, copy the following content into the Statement, and click Save.

{
"Sid": "test3",
"Quota": {
"WritesQps": "",
"ReadsQps": "",
"ListQps": "",
"WritesRate": "3000",
"ReadsRate": ""
},
"Principal": [
"*"
],
"Resource": "trn:tos:::bucketevent/*"
}

Throttling bandwidth for a specific user

In this section, we will set a write bandwidth limit of 3,000 Mbps for the IAM user "aaa" in China (Beijing).

Log in to the TOS console.

In the left navigation pane, select Flow control management > QoS policy management.

On the QoS policy management page, set Region to China (Beijing) in the upper-left corner.

Configure the policy using your preferred view.

Visual view
JSON view
Configure QoS policies by visual view:
Click Create policy.
On the Create QoS policy page, set the following parameters.
Policy configuration method: Select Visual view.
Policy name: Enter a name for the policy. In this example, enter test4.
Policy Type: Select Threshold traffic control.
QoS value: Set Category to WritesRate, and Value to 3,000.
Authorized user: Set Authorized user to Specified account and select Current main account. In the Sub account name section, click Add row and select aaa from the list.
User Policy: Select Include the above users.
Resource: Select All buckets.
Resource strategy: Select Include the above resources.
Condition: No conditions are required for this scenario.
After completing the settings, click Next step.
After verifying the details, click Confirm.
On the JSON view tab, click Edit. Then, copy the following content into the Statement, and click Save.

{
"Sid": "test4",
"Quota": {
"WritesQps": "",
"ReadsQps": "",
"ListQps": "",
"WritesRate": "3000",
"ReadsRate": ""
},
"Principal": [
"trn:iam::214748****:user/aaa"
],
"Resource": "*"
}

Prioritizing bandwidth for a specific bucket

In this section, we will use the 'bucketevent' bucket in China (Beijing) as an example. The default write bandwidth limit for this region is 10,000 Mbps. To ensure 'bucketevent' has a write bandwidth limit of 7,000 Mbps while the other buckets in this region collectively have a limit of 3,000 Mbps, we will set the limit for the other buckets to 3,000 Mbps.

Log in to the TOS console.

In the left navigation pane, select Flow control management > QoS policy management.

On the QoS policy management page, set Region to China (Beijing) in the upper-left corner.

Configure the policy using your preferred view.

Visual view
JSON view
Configure QoS policies by visual view:
Click Create policy.
On the Create QoS policy page, set the following parameters.
Policy configuration method: Select Visual view.
Policy name: Enter a name for the policy. In this example, enter test3.
Policy Type: Select Threshold traffic control.
QoS value: Set Category to WritesRate, and Value to 3,000.
Authorized user: Select All users.
User Policy: Select Include the above users.
Resource scope: Check the Objects in bucket checkbox. Set Bucket name to bucketevent and Scope of application to All objects.
Resource strategy: Select Exclude the above resources.
Condition: No conditions are required for this scenario.
After completing the settings, click Next step.
After verifying the details, click Confirm.
On the JSON view tab, click Edit. Then, copy the following content into the Statement, and click Save.

{
"Sid": "test3",
"Quota": {
"WritesQps": "",
"ReadsQps": "",
"ListQps": "",
"WritesRate": "3000",
"ReadsRate": ""
},
"Principal": [
"*"
],
"NotResource": "trn:tos:::bucketevent/*"
}

Prioritizing bandwidth for a specific user

In this section, we will use the IAM user "aaa" and the China (Beijing) region as an example. The default write bandwidth limit for this region is 10,000 Mbps. To ensure aaa has a write bandwidth limit of 7,000 Mbps while the other users collectively have a limit of 3,000 Mbps in this region, we will set the limit for the other users to 3,000 Mbps.

Log in to the TOS console.

In the left navigation pane, select Flow control management > QoS policy management.

On the QoS policy management page, set Region to China (Beijing) in the upper-left corner.

Configure the policy using your preferred view.

Visual view
JSON view
Configure QoS policies by visual view:
Click Create policy.
On the Create QoS policy page, set the following parameters.
Policy configuration method: Select Visual view.
Policy name: Enter a name for the policy. In this example, enter test4.
Policy Type: Select Threshold traffic control.
QoS value: Set Category to WritesRate, and Value to 3,000.
Authorized user: Set Authorized user to Specified account and select Current main account. In the Sub account name section, click Add row and select aaa from the list.
User Policy: Select Exclude the above users.
Resource: Select All buckets.
Resource strategy: Select Include the above resources.
Condition: No conditions are required for this scenario.
After completing the settings, click Next step.
After verifying the details, click Confirm.
On the JSON view tab, click Edit. Then, copy the following content into the Statement, and click Save.

{
"Sid": "test4",
"Quota": {
"WritesQps": "",
"ReadsQps": "",
"ListQps": "",
"WritesRate": "3000",
"ReadsRate": ""
},
"NotPrincipal": [
"trn:iam::214748****:user/aaa"
],
"Resource": "*"
}

Implementing priority‑based throttling for various services accessing the same TOS resources

In this section, we will set the guaranteed write bandwidth quotas to 1,000 Mbps for vePFS and 2,000 Mbps for EMR when accessing the "bucketevent" bucket. The total write bandwidth quota is 3,000 Mbps.

Log in to the TOS console.

In the left navigation pane, select Flow control management > QoS policy management.

On the QoS policy management page, set Region to China (Beijing) in the upper-left corner.

Configure the policy using your preferred view.

Visual view
JSON view
Configure QoS policies by visual view:
Click Create policy.
On the Create QoS policy page, set the following parameters.
Policy configuration method: Select Visual view.
Policy name: Enter a name for the policy. In this example, enter "test-priority1".
Policy type: Select Priority traffic control.
QoS value: Set Category to WritesRate, and Value to 3,000 Mbps.
Priority configuration: Click Add priority to set the guaranteed bandwidth quota and priority level for vePFS.
Guaranteed flow control value: Set Category to WritesRate, and Value to 1,000 Mbps.
Authorized user: Set Authorized user to Specified account and select Current main account. In the Role name section, click Add row to apply ServiceRoleForVEPFS.
User Policy: Select Include the above users.
Resource: Check the Objects in bucket checkbox. Set Bucket name to bucketevent and Scope of application to All objects.
Resource strategy: Select Include the above resources.
Condition: No conditions are required for this scenario.
After verifying the details, click Confirm.
Priority configuration: Click Add priority to set the guaranteed bandwidth quota and priority level for EMR.
Guaranteed flow control value: Set Category to WritesRate, and Value to 2,000 Mbps.
Authorized user: Set Authorized user to Specified account and select Current main account. In the Role name section, click Add row to apply ServiceRoleForEMROLAP.
User Policy: Select Include the above users.
Resource: Check the Objects in bucket checkbox. Set Bucket name to bucketevent and Scope of application to All objects.
Resource strategy: Select Include the above resources.
Condition: No conditions are required for this scenario.
After verifying the details, click OK.
On the JSON view tab, click Edit. Then, copy the following content into the Statement, and click Save.

{
"Sid": "test-priority1",
"Quota": {
"WritesRate": "3000"
},
"Priority": [
{
"PriorityLevel": 1,
"GuaranteedQuota": {
"WritesRate": "1000"
},
"Principal": [
"trn:iam::214748****:role/ServiceRoleForVePFS"
],
"Resource": "trn:tos:::bucketevent/*"
},
{
"PriorityLevel": 2,
"GuaranteedQuota": {
"WritesRate": "2000"
},
"Principal": [
"trn:iam::214748****:role/ServiceRoleForEMROLAP"
],
"Resource": "trn:tos:::bucketevent/*"
}
],
"Condition": {}
}

After completing the settings, click Next step.

After verifying the details, click Confirm.

Implementing priority‑based throttling across multiple buckets

In this section, we will use the "bucketevent1" and "bucketevent2" buckets in China (Beijing) as examples. The default write bandwidth limit for this region is 10,000 Mbps. We will set guaranteed write bandwidth quotas of 3,000 Mbps for both "bucketevent1" and "bucketevent2".

Log in to the TOS console.

In the left navigation pane, select Flow control management > QoS policy management.

On the QoS policy management page, set Region to China (Beijing) in the upper-left corner.

Configure the policy using your preferred view.

Visual view
JSON view
Configure QoS policies by visual view:
Click Create policy.
On the Create QoS policy page, set the following parameters.
Policy configuration method: Select Visual view.
Policy name: Enter a name for the policy. In this example, enter "test-priority2".
Policy type: Select Priority traffic control.
QoS value: Set Category to WritesRate, and Value to 10,000 Mbps.
Priority configuration: Click Add priority to set the guaranteed bandwidth quota and priority level for bucketevent1.
Guaranteed flow control value: Set Category to WritesRate, and Value to 3,000 Mbps.
Authorized user: Select All users.
User Policy: Select Include the above users.
Resource scope: Check the Objects in bucket checkbox. Set Bucket name to bucketevent1 and Scope of application to All objects.
Resource strategy: Select Include the above resources.
Condition: No conditions are required for this scenario.
After verifying the details, click Confirm.
Priority configuration: Click Add priority to set the guaranteed bandwidth quota and priority level for bucketevent2.
Guaranteed flow control value: Set Category to WritesRate, and Value to 3,000 Mbps.
Authorized user: Select All users.
User Policy: Select Include the above users.
Resource scope: Check the Objects in bucket checkbox. Set Bucket name to bucketevent2 and Scope of application to All objects.
Resource strategy: Select Include the above resources.
Condition: No conditions are required for this scenario.
After verifying the details, click OK.
On the JSON view tab, click Edit. Then, copy the following content into the Statement, and click Save.

{
"Sid": "test-priority2",
"Quota": {
"WritesRate": "10000"
},
"Priority": [
{
"PriorityLevel": 1,
"GuaranteedQuota": {
"WritesRate": "3000"
},
"Principal": [
"*"
],
"Resource": "trn:tos:::bucketevent1/*"
},
{
"PriorityLevel": 2,
"GuaranteedQuota": {
"WritesRate": "3000"
},
"Principal": [
"*"
],
"Resource": "trn:tos:::bucketevent2/*"
}
],
"Condition": {}
}

After completing the settings, click Next step.

After verifying the details, click Confirm.

Torch Object Storage