Docs

Direct Connect

Qos policy

ModifyDirectConnectTrafficQosRuleAttributes - Modifying a traffic rule

Call ModifyDirectConnectTrafficQosRuleAttributes to update information for a specified default traffic rule.

Instructions

This API only supports modifying default traffic rules. Manually added traffic rules cannot be modified. To modify, call DeleteDirectConnectTrafficQosRule to delete the rule and then call CreateDirectConnectTrafficQosRule to recreate it.

Only the retagged DSCP of the default traffic rule can be modified. Other information cannot be changed.

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

The interface name. The current API name is ModifyDirectConnectTrafficQosRuleAttributes.

Version String required Example: 2020-04-01

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

DirectConnectTrafficQosRuleId String required Example: dqr-1jfwefksx5****

The ID of the default traffic rule.

You can call DescribeDirectConnectTrafficQosRules to query the traffic rule ID. The queue with DirectConnectTrafficQosRuleName set to Default and Priority set to 65535 is a default traffic rule.

Remarking DSCP Integer required Example: 53

Modify the DSCP value in the traffic. Value range: 0-63. Use -1 if not effective.

Response parameters

This API does not have specific response parameters. For more information, see Response structure.

Request examples

GET /?Action=ModifyDirectConnectTrafficQosRuleAttributes&Version=2020-04-01&DirectConnectTrafficQosRuleId=dqr-in0gq79lqygw8gbssy0q****&RemarkingDscp=45 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": "20241107160755EC1FDE4A8330156****",​
        "Action": "ModifyDirectConnectTrafficQosRuleAttributes",​
        "Version": "2020-04-01",​
        "Service": "directconnect",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "RequestId": "20241107160755EC1FDE4A8330156****"​
    }​
}​

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	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	InvalidDirectConnectTrafficQosPolicy.InvalidStatus	The specified direct connect traffic qos policy is not in the correct status for the request.	The specified QoS policy cannot respond to this request due to its status.
400	InvalidDirectConnectTrafficQosQueue.InvalidStatus	The specified direct connect traffic qos queue is not in the correct status for the request.	The specified QoS traffic queue cannot respond to this request due to its status.
400	InvalidDirectConnectTrafficQosRule.CustomRuleUnsupported	It is not supported to modify the direct connect traffic qos rule with custom priority.	Modifying custom QoS traffic rules is not supported.
400	InvalidDirectConnectTrafficQosRule.InvalidRemarkingDscp	The specified remarking dscp of the direct connect traffic qos rule is invalid. Remarking dscp only support -1, 0~63.	The retagged DSCP of the specified QoS traffic rule is invalid. It must be -1 or an integer between 0 and 63.
400	InvalidDirectConnectTrafficQosRule.InvalidStatus	The specified direct connect traffic qos rule is not in the correct status for the request.	The specified QoS traffic rule cannot respond to this request due to its status.
404	InvalidDirectConnectTrafficQosRule.NotFound	The specified direct connect traffic qos rule does not exist.	The specified QoS traffic rule does not exist.

Last updated: 2026.03.06 15:29:55