Docs

Transit Router

Traffic qos queue policy

CreateTransitRouterTrafficQosQueuePolicy - Creating a traffic queue policy

Call the CreateTransitRouterTrafficQosQueuePolicy API to create a traffic queue policy.

Notes

You can create up to 10 traffic queue policies for a single Transit Router (TR) instance by default.

A traffic queue policy consists of 1 default queue and additionally supports up to 64 custom queues.

You can add up to 10 queues (excluding the default queue) when creating a new traffic queue policy.

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.

Go to debug

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: CreateTransitRouterTrafficQosQueuePolicy

The interface name. The current API name is CreateTransitRouterTrafficQosQueuePolicy.

Version String required Example: 2020-04-01

The interface version. The current API version is 2020-04-01.

TransitRouterId String required Example: tr-7qthudw0ll6jmc****

The ID of the Transit Router (TR) instance. You can call the DescribeTransitRouters API to obtain the TR instance ID.

TransitRouterTrafficQosQueuePolicyName String optional Example: tmp-02

Name of the traffic queue policy.

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 the ID of the traffic queue policy.

Description String optional Example: This traffic qos queue policy is used for test.

Description of the traffic queue policy.

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, idempotency check is not performed.

Response parameters

The following only details response parameters specific to this API. For more information, see Response structure.

TransitRouterTrafficQosQueuePolicyId String Example: tr-tqp-hy13n2l4c6c0v****

ID of the traffic queue policy.

Request examples

GET /?Action=CreateTransitRouterTrafficQosQueuePolicy&Version=2020-04-01&TransitRouterId=tr-7qthudw0ll6jmc**** HTTP/1.1​
Host: transitrouter.cn-beijing.volcengineapi.com​
X-Date: 20250731T090828Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250731/cn-beijing/transitrouter/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​

Response examples

{​
  "ResponseMetadata": {​
    "RequestId": "2025073117083119422410725570EAE8",​
    "Action": "CreateTransitRouterTrafficQosQueuePolicy",​
    "Version": "2020-04-01",​
    "Service": "transitrouter",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "TransitRouterTrafficQosQueuePolicyId": "tr-tqp-hy13n2l4c6c0v****"​
  }​
}​

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.

Status code	Error codes	Error message	Explanation
400	IdempotentParameterMismatch	Arguments on this idempotent request are inconsistent with arguments used in previous request(s).	The parameters of this idempotent request are inconsistent with those used in the previous request.
400	InvalidDescription.Malformed	The specified description is malformed.	The format of specified description is invalid. Correct the description format and retry.
400	InvalidDescription.TooLong	The specified description is malformed. Ensure the maximum length of description is 255.	The format of specified description is invalid. A description must not exceed 255 characters.
400	InvalidName.Malformed	The specified name is malformed.	The format of the specified name is invalid. Correct the name format and retry.
400	InvalidName.TooLong	The specified name is malformed. Ensure the maximum length of name is 128.	The format of the specified name is invalid. A name must not exceed 128 characters.
400	InvalidParameter.ClientTokenMalformed	The specified parameter ClientToken is malformed.	The format of specified ClientToken is invalid. It must not exceed 64 ASCII characters.
400	InvalidTransitRouter.InvalidBusinessStatus	The request is denied because the specified Transit Router is shut down due to arrears.	The specified Transit Router (TR) is suspended due to overdue payments. This action is unsupported.
400	InvalidTransitRouter.InvalidStatus	The specified Transit Router is not in the correct status for the request.	The specified Transit Router (TR) is in a status that cannot respond to the request.
400	InvalidTransitRouter.QosNotSupported	The specified Transit Router does not support the QoS feature.	The specified TR instance does not support QoS.
400	QuotaExceeded.TransitRouterTrafficQosQueuePolicy	You've reached the limit on the number of traffic qos queue policies that you can create on one Transit Router.	You have reached the maximum number of traffic queue policies that you can create for a single TR.
403	Forbidden.CreateTrafficQosQueuePolicy	You are not authorized to create traffic qos queue policy on Transit Router.	No permission to create any traffic queue policies. Enable the allowlist for the QoS capability.
403	Forbidden.NoPermissionToOperate	You are not authorized to operate the specified resource.	No permission to manage the specified resource.
404	InvalidTransitRouter.NotFound	The specified Transit Router does not exist.	The specified Transit Router (TR) does not exist.
412	IdempotentProcessing	The request uses the same client token as a previous one that is still in process.	The idempotent request is in progress.

Last updated: 2026.03.11 11:24:56