Direct Connect
Direct Connect
Document
- Documentation
Direct ConnectAPI ReferenceQos policyDescribeDirectConnectTrafficQosRules - Querying traffic rules
Copy page
Download PDFQos policy
DescribeDirectConnectTrafficQosRules - Querying traffic rules
Copy pageDownload PDFDescribeDirectConnectTrafficQosRules - Querying traffic rules
Call DescribeDirectConnectTrafficQosRules to query traffic rules 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 requiredExample: DescribeDirectConnectTrafficQosRules
The interface name. The current API name is DescribeDirectConnectTrafficQosRules.
Version String required Example: 2020-04-01
The interface version. The current API version is 2020-04-01.
DirectConnectTrafficQosRuleIds.N String optional Example: dqr-bwbhc****
The ID of the traffic rule.
- N represents the sequence number of a traffic rule.
- Separate multiple IDs with ampersands (&).
DirectConnectTrafficQosQueueId String optional Example: dcq-i718g7fap8t1t****
The ID of the QoS policy to which the traffic rule belongs.
DirectConnectTrafficQosRuleName String optional Example: dcq-test
The name of the QoS policy to which the traffic rule belongs.
Priority Integer optional Example: 1
The priority of the traffic rule.
Protocol String optional Example: TCP
The protocol type. Values:
- ICMP
- ICMPV6
- TCP
- UDP
- GRE
- ALL
MatchDscp Integer optional Example: 1
The original DSCP value.
RemarkingDscp Integer optional Example: 2
The retagged DSCP value.
PageNumber Integer optional Example: 1
The page number of the list.
- Set a non-negative integer to this parameter.
- If you omit it or set it to 0, the value 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 traffic rules meeting the query conditions.
DirectConnectTrafficQosRules Object[] Example: -
The list of traffic rules.
Status String Example: Available
The status of the traffic rule.
- Creating
- Deleting
- Pending: Configuration in progress.
- Available
Priority Integer Example: 10
The priority of the traffic rule.
Protocol String Example: TCP
The protocol type.
MatchDscp Integer Example: 10
The value of Match DSCP.
Description String Example: test dqr
The description of the traffic rule.
RemarkingDscp Integer Example: 16
The retagged DSCP value.
SourcePortEnd Integer Example: 100
The end value of the source port number range.
SourceCidrBlock String Example: 10.XX.XX.0/24
The source CIDR block.
SourcePortStart Integer Example: 1
The start value of the source port number range.
DestinationPortEnd Integer Example: 100
The end value of the destination port number range.
DestinationCidrBlock String Example: 20.XX.XX.0/24
The destination CIDR block.
DestinationPortStart Integer Example: 1
The start value of the destination port number range.
DirectConnectTrafficQosRuleId String Example: dqr-18agtw13n58ycd09u****
The ID of the traffic rule.
DirectConnectTrafficQosQueueId String Example: dqq-1gta6t1cwd4c8rh0***
The ID of the traffic queue associated with the traffic rule.
DirectConnectTrafficQosPolicyId String Example: dcq-59agtw20n57ycd0ay****
The ID of the QoS policy to which the traffic rule belongs.
DirectConnectTrafficQosRuleName String Example: dqr-18agtw1ycd09u****
The name of the traffic rule.
Request examples
GET /?DirectConnectTrafficQosRuleName=dcq-test&DirectConnectTrafficQosQueueId=dqq-in0gqqzwvi808gbssy****&Action=DescribeDirectConnectTrafficQosRules&Version=2020-04-01&DirectConnectTrafficQosRuleIds.1=dqr-2fezsa5pcdnuo59gp68x**** 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": "DescribeDirectConnectTrafficQosRules",
"Version": "2020-04-01",
"Service": "directconnect",
"Region": "cn-north-1"
},
"Result": {
"DirectConnectTrafficQosRules": [
{
"Status": "Available",
"Priority": 10,
"Protocol": "TCP",
"MatchDscp": 10,
"Description": "test dqr",
"RemarkingDscp": 16,
"SourcePortEnd": 100,
"SourceCidrBlock": "10.XX.XX.0/24",
"SourcePortStart": 1,
"DestinationPortEnd": 100,
"DestinationCidrBlock": "20.XX.XX.0/24",
"DestinationPortStart": 1,
"DirectConnectTrafficQosRuleId": "dqr-18agtw13n58ycd09u****",
"DirectConnectTrafficQosQueueId": "dqq-1gta6t1cwd4c8rh0***",
"DirectConnectTrafficQosPolicyId": "dcq-59agtw20n57ycd0ay****",
"DirectConnectTrafficQosRuleName": "dqr-18agtw1ycd09u****"
}
],
"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.
Last updated: 2026.03.06 15:29:55
All rights reserved © Beijing Volcano Engine Technology Co., Ltd2024
