Docs

Transit Router

Traffic qos marking policy

AssociateTransitRouterTrafficQosMarkingPolicyToAttachment - Associating a traffic marking policy with an attachment

Call the AssociateTransitRouterTrafficQosMarkingPolicyToAttachment API to associate a traffic marking policy with a Transit Router (TR) attachment.

Precautions

Traffic marking may be impacted by enabling a traffic marking policy. If the bandwidth allocated to the scheduling queue matched by the traffic marking is insufficient for actual business requirements, normal service forwarding may be impacted.

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 requiredExample value: AssociateTransitRouterTrafficQosMarkingPolicyToAttachment

The interface name. The current API name is AssociateTransitRouterTrafficQosMarkingPolicyToAttachment.

Version String required Example: 2020-04-01

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

TransitRouterAttachmentId String required Example: tr-attach-13n2l4c****

The attachment ID. Currently, only inter-region attachments are supported. You can call DescribeTransitRouterPeerAttachments to obtain the ID of the inter-region attachment.

TransitRouterTrafficQosMarkingPolicyId String required Example value: tr-tmp-hy13n2l4c6c0v****

ID of the traffic marking policy. You can call the DescribeTransitRouterTrafficQosMarkingPolicies API to obtain the ID of the traffic marking policy.

Response parameters

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

Request examples

GET /?Action=AssociateTransitRouterTrafficQosMarkingPolicyToAttachment&Version=2020-04-01&TransitRouterAttachmentId=tr-attach-13n2l4c****&TransitRouterTrafficQosMarkingPolicyId=tr-tmp-hy13n2l4c6c0v**** HTTP/1.1​
Host: transitrouter.cn-beijing.volcengineapi.com​
X-Date: 20250731T090108Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250731/cn-beijing/transitrouter/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​

Response examples

{​
  "ResponseMetadata": {​
    "RequestId": "202507311701120060441162019A0618",​
    "Action": "AssociateTransitRouterTrafficQosMarkingPolicyToAttachment",​
    "Version": "2020-04-01",​
    "Service": "transitrouter",​
    "Region": "cn-beijing"​
  },​
  "Result": {}​
}​

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	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. Action 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	InvalidTransitRouterAttachment.InvalidStatus	The specified Transit Router Attachment is not in the correct status for the request.	The specified network instance attachment is in a status that cannot respond to the request.
400	InvalidTransitRouterTrafficQosMarkingPolicyAssociation.AttachmentTypeNotSupport	The specified Transit Router attachment type does not support to associate traffic qos marking policy.	The type of the specified network instance attachment does not support configuring traffic marking policies.
400	InvalidTransitRouterTrafficQosMarkingPolicyAssociation.TransitRouterMismatch	The specified attachment and traffic qos marking policy do not belong to the same Transit Router.	The specified network instance attachment and the traffic marking policy are not associated with the same TR.
403	Forbidden.NoPermissionToOperate	You are not authorized to operate the specified resource.	No permission to manage the specified resource.
404	InvalidTransitRouterAttachment.NotFound	The specified Transit Router attachment does not exist.	The specified network instance attachment does not exist.
404	InvalidTransitRouterTrafficQosMarkingPolicy.NotFound	The specified Transit Router traffic qos marking policy does not exist.	The specified traffic marking policy does not exist.
409	InvalidTransitRouterTrafficQosMarkingPolicyAssociation.Conflict	The specified Transit Router attachment has already been associated with a traffic qos marking policy.	The specified network instance attachment has a configured traffic marking policy. Duplicate configuration is not permitted.

Last updated: 2026.01.06 11:56:29