Docs

Direct Connect

Qos policy

DeleteDirectConnectTrafficQosPolicy - Deleting a specified QoS policy

Call DeleteDirectConnectTrafficQosPolicy to delete a specified QoS policy.

Instructions

The QoS policy to be deleted is not associated with any Direct Connect (DC) Connections, and contains no traffic queues other than the default queue (named Default). If present, first disassociate all DC Connections associated with the QoS policy and delete the traffic queues before deleting the QoS policy. You can call ModifyDirectConnectTrafficQosPolicyAttributes to disassociate the DC Connection and DeleteDirectConnectTrafficQosQueue to delete the traffic queue.

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

The interface name. The current API name is DeleteDirectConnectTrafficQosPolicy.

Version String required Example: 2020-04-01

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

DirectConnectTrafficQosPolicyId String required Example: dcq-a2du7fojk17****

The ID of the QoS policy to be deleted.

You can call the DescribeDirectConnectTrafficQosPolicies API to query the QoS policy ID.

Response parameters

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

Request examples

GET /?Action=DeleteDirectConnectTrafficQosPolicy&Version=2020-04-01&DirectConnectTrafficQosPolicyId=dcq-2fezrjmq3vif459gp67**** 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": "202411071550407A413E6A9D8BD4****",​
        "Action": "DeleteDirectConnectTrafficQosPolicy",​
        "Version": "2020-04-01",​
        "Service": "directconnect",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "RequestId": "202411071550407A413E6A9D8BD4****"​
    }​
}​

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	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	InvalidDirectConnectTrafficQosPolicy.WithAssociation	The specified traffic qos policy is in use. If you are trying to delete the traffic qos policy, ensure that its associated direct connect connections have been detached.	The specified QoS policy is in use. Before attempting to delete a QoS policy, ensure all associated DC Connections have been disassociated.
400	InvalidDirectConnectTrafficQosPolicy.WithTrafficQosQueue	The specified traffic qos policy is in use. If you are trying to delete the traffic qos policy, ensure that its traffic qos queues have been deleted.	The specified QoS policy is in use. Before attempting to delete a QoS policy, ensure all associated traffic queues have been deleted.
400	QuotaExceeded.DcTrafficQosPolicy	You've reached the limit on the number of traffic qos policies that you can create.	You have reached the maximum number of QoS policies that can be created.
404	InvalidDirectConnectTrafficQosPolicy.NotFound	The specified direct connect traffic qos policy does not exist.	The specified QoS policy does not exist.

Last updated: 2026.03.06 15:29:55