You need to enable JavaScript to run this app.
Direct Connect

Direct Connect

Copy page
Download PDF
Qos policy
DescribeDirectConnectTrafficQosQueues - Querying qualified traffic queues
Copy page
Download PDF
DescribeDirectConnectTrafficQosQueues - Querying qualified traffic queues
Call DescribeDirectConnectTrafficQosQueues to query information about traffic queues that meet the specified conditions.​
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: DescribeDirectConnectTrafficQosQueues​
The interface name. The current API name is DescribeDirectConnectTrafficQosQueues.​
​
Version String required Example: 2020-04-01​
The interface version. The current API version is 2020-04-01.​
​
DirectConnectTrafficQosQueueIds.N String optional Example: dqq-93a1ee****​
The ID of the traffic queue.​
  • N represents the sequence number of a queue ID. You can call up to 100 IDs per request.​
  • Separate multiple IDs with ampersands (&).​
​
DirectConnectTrafficQosPolicyId String optional Example: dcq-3bf8a0f4****​
The ID of the QoS policy associated with the traffic queue.​
​
DirectConnectTrafficQosQueueName String optional Example: dqq-name​
The name of the traffic queue.​
​
QueueType String optional Example: High​
The type of the traffic queue.​
  • High: High-priority queue.​
  • Medium: Normal-priority queue.​
  • Default: Default-priority queue.​
​
PageNumber Integer optional Example: 1​
The page number of the list.​
  • Set a non-negative integer to this parameter.​
  • If left blank or set to 0, it defaults to 1.​
​
PageSize Integer optional Example: 20​
The number of entries per page in a pagination query. Maximum: 100. Default: 20.​
​
​
​
Response parameters​
The following only details response parameters specific to this API. For more information, see Response structure.​
PageSize Integer Example: 20​
Number of entries per page in the current pagination.​
​
PageNumber Integer Example: 1​
The current page number.​
​
TotalCount Integer Example: 1​
The total number of qualified traffic queues.​
​
DirectConnectTrafficQosQueues Object[] Example: -​
The list of traffic queues.​
Status String Example: Available​
The status of the traffic queue.​
  • Creating​
  • Deleting​
  • Pending: ​​Configuration in progress.​
  • Available​
​
QueueType String Example: High​
The type of the traffic queue.​
  • High: High-priority queue.​
  • Medium: Normal-priority queue.​
  • Default: Default-priority queue.​
​
UpdateTime String Example: 2021-04-09T08:36:47+08:00​
The time when the traffic queue is updated.​
​
Description String Example: test dqq​
The description of the traffic queue.​
​
CreationTime String Example: 2021-04-09T08:36:47+08:00​
The time when the traffic queue is created.​
​
BandwidthPercent Integer Example: 10​
The bandwidth percentage of the traffic queue.​
  • Returns the corresponding percentage value when the traffic queue type is Medium or Default.​
  • Returns "0" when the traffic queue type is High.​
​
DirectConnectTrafficQosQueueId String Example: dqq-5gta2c1cwd4c4gh0***​
The ID of the traffic queue.​
​
DirectConnectTrafficQosRuleIds String[] Example: dqr-g8agtw13n58gcd89a****​
The ID of the traffic rule under the traffic queue.​
​
DirectConnectTrafficQosPolicyId String Example: dcq-9atcc1cwd4c8g0a***​
The ID of the traffic queue.​
​
DirectConnectTrafficQosQueueName String Example: dqq-name​
The name of the traffic queue.​
​
​
​
​
Request examples​
​
GET /?Action=DescribeDirectConnectTrafficQosQueues&DirectConnectTrafficQosQueueIds.1=dqq-in0gqqzwvi808gbssyj5****&Version=2020-04-01 HTTP/1.1​
Host: directconnect.cn-beijing.volcengineapi.com​
X-Date: 20251121T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/directconnect/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
Response examples​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "DescribeDirectConnectTrafficQosQueues",​
"Version": "2020-04-01",​
"Service": "directconnect",​
"Region": "cn-north-1"​
},​
"Result": {​
"DirectConnectTrafficQosQueues": [​
{​
"Status": "Available",​
"QueueType": "High",​
"UpdateTime": "2021-04-09T08:36:47+08:00",​
"Description": "test dqq",​
"CreationTime": "2021-04-09T08:36:47+08:00",​
"BandwidthPercent": 10,​
"DirectConnectTrafficQosQueueId": "dqq-5gta2c1cwd4c4gh0***",​
"DirectConnectTrafficQosRuleIds": [​
"dqr-g8agtw13n58gcd89a****"​
],​
"DirectConnectTrafficQosPolicyId": "dcq-9atcc1cwd4c8g0a***",​
"DirectConnectTrafficQosQueueName": "dqq-name"​
}​
],​
"PageNumber": 1,​
"PageSize": 20,​
"TotalCount": 1​
}​
}​
​
Error codes​
The table below describes the error codes for this API that are associated with business logic. For details, see Common error codes.​
​
Status code​
Error codes​
Error message​
Description​
400​
DryRunOperation​
Exception raised to indicate a successfully authorized action when the DryRun flag is set to true.​
This request is set to DryRun. The action is authorized but not executed.​
400​
InvalidPage.Malformed​
The specified page is malformed.​
The specified pagination parameter is invalid.​
400​
LimitExceeded.DirectConnectTrafficQosQueueId​
You've reached the limit on the number of direct connect traffic qos queue IDs that you can describe.​
You have reached the maximum number of QoS traffic queues that can be queried.​
​
Last updated: 2026.03.06 15:29:55