Transit Router
Transit Router
Document
- Documentation
Transit RouterAPI referenceTraffic qos queue policyCreateTransitRouterTrafficQosQueueEntry - Adding a traffic queue
Copy page
Download PDFTraffic qos queue policy
CreateTransitRouterTrafficQosQueueEntry - Adding a traffic queue
Copy pageDownload PDFCreateTransitRouterTrafficQosQueueEntry - Adding a traffic queue
Call the CreateTransitRouterTrafficQosQueueEntry API to add queues to a traffic queue policy.
Instructions
A traffic queue policy consists of 1 default queue and additionally supports up to 64 custom queues.
Precautions
If the allocated bandwidth is insufficient for actual business requirements after adding a queue, normal service forwarding may be impacted.
Debug
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
Request parameters
The following only details request parameters specific to this API and key common parameters. For more information, see Common parameters.
Action String required Example: CreateTransitRouterTrafficQosQueueEntry
The interface name. The current API name is CreateTransitRouterTrafficQosQueueEntry.
Version String required Example: 2020-04-01
The interface version. The current API version is 2020-04-01.
TransitRouterTrafficQosQueuePolicyId String required Example: tr-tqp-hy13n2l4c6c0v****
ID of the traffic queue policy. You can call the DescribeTransitRouterTrafficQosQueuePolicies API to obtain the traffic queue policy ID.
Dscps.N Integer required Example: 1
The DSCP value that the queue should match. Value range: 0-63.
- N represents the serial number of the DSCP value, ranging from 1 to 64.
- Separate multiple DSCP values with ampersands (&).
BandwidthPercent Integer optional Example: 10
The percentage of cross-region bandwidth available for the queue. Value range: 0-100.
If the value is 0, traffic that successfully matches the queue will be discarded.
TransitRouterTrafficQosQueueEntryName String required Example: tqe-02
The queue name.
- Must start with a letter, number, or Chinese character. May include letters, numbers, Chinese characters, and the following symbols: periods (.), underscores (_), and hyphens (-).
- Must be 1 to 128 characters.
- If you do not provide this parameter or leave it unset, it defaults to empty.
Description String optional Example: This traffic qos queue entry is used for test.
The description of the queue.
- Must start with a letter, number, or Chinese character. May include letters, numbers, Chinese characters, and the following symbols: commas (,), periods (.), underscores (_), spaces ( ), equal signs (=), hyphens (-), Chinese commas ( ， ), and Chinese periods ( 。 ).
- Must be 0 to 255 characters.
- If you do not provide this parameter or leave it unset, it defaults to an empty string.
ClientToken String optional Example: 123e4567-e89b-12d3-a456-42665544****
The Client Token that is used to ensure the request idempotency.
- This parameter value is auto-generated by the client. Ensure uniqueness across requests, preventing duplicate actions caused by multiple client retries during API timeouts or server internal errors.
- Must not exceed 64 ASCII characters.
- If you do not set this parameter, the idempotency check is not performed.
Priority String optional Example: High
The priority of the traffic queue.
- Normal: Normal priority.
- High: High priority.
Response parameters
The following only details response parameters specific to this API. For more information, see Response parameters.
TransitRouterTrafficQosQueueEntryId String Example: tr-tqe-1i5i8khf9m58gae5kcx6****
Traffic queue ID.
Request examples
Host: transitrouter.cn-beijing.volcengineapi.com
X-Date: 20250815T040532Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250815/cn-beijing/transitrouter/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
Response examples
{
"ResponseMetadata": {
"RequestId": "20250815120534155194148038FB8C6D",
"Action": "CreateTransitRouterTrafficQosQueueEntry",
"Version": "2020-04-01",
"Service": "transitrouter",
"Region": "cn-beijing"
},
"Result": {
"TransitRouterTrafficQosQueueEntryId": "tr-tqe-1i5i8khf9m58gae5kcx6****"
}
}
Error codes
The table below describes the error codes for this API that are associated with business logic. For more information, see Common error codes.
Last updated: 2026.03.11 11:24:56
All rights reserved © Beijing Volcano Engine Technology Co., Ltd2024
