Disassociates a route table of an Enterprise Edition transit router from a prefix list.

Usage notes

After you disassociate a route table of an Enterprise Edition transit router from a prefix list, the routes that point to the CIDR blocks in the prefix list are automatically withdrawn from the route table. Before you disassociate the route table of an Enterprise Edition transit router from a prefix list, you must migrate workloads that use the routes in case services are interrupted.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DeleteTransitRouterPrefixListAssociation

The operation that you want to perform. Set the value to DeleteTransitRouterPrefixListAssociation.

ClientToken String No 123e4567-e89b-12d3-a456-4266****

The client token that is used to ensure the idempotence of the request.

You can use the client to generate the value, but you must make sure that it is unique among different requests. ClientToken can contain only ASCII characters.

Note If you do not set this parameter, ClientToken is set to the value of RequestId. The value of RequestId of each API request may be different.
RegionId String Yes cn-hangzhou

The ID of the region where the transit router is deployed.

You can call the DescribeChildInstanceRegions operation to query the most recent region list.

TransitRouterId String Yes tr-6ehx7q2jze8ch5ji0****

The ID of the transit router.

PrefixListId String Yes pl-6ehtn5kqxgeyy08fi****

The ID of the prefix list.

TransitRouterTableId String Yes vtb-6ehgc262hr170qgyc****

The ID of the route table of the transit router.

NextHop String Yes tr-attach-flbq507rg2ckrj****

The ID of the next hop connection.

Note If NextHopType is set to BlackHole, set this parameter to BlackHole.
NextHopType String No VPC

The type of the next hop. Valid values:

  • BlackHole: specifies that all the CIDR blocks in the prefix list are blackhole routes. Packets destined for the CIDR blocks are dropped.
  • VPC: specifies that the next hop of the CIDR blocks in the prefix list is a virtual private cloud (VPC) connection.
  • VBR: specifies that the next hop of the CIDR blocks in the prefix list is a virtual border router (VBR) connection.
  • TR: specifies that the next hop of the CIDR blocks in the prefix list is an inter-region connection.
DryRun Boolean No false

Specifies whether only to check the request. Valid values:

  • true: prechecks the request but does not disassociate the route table from the prefix list. The system checks the required parameters, the request format, and the service limits. If the request fails to pass the precheck, an error message is returned. If the request passes the precheck, the DryRunOperation error code is returned.
  • false (default): prechecks the request. If the request passes the check, the route table is disassociated from the prefix list.

Response parameters

Parameter Type Example Description
RequestId String 835E7F4B-B380-4E0F-96A5-6EA572388047

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DeleteTransitRouterPrefixListAssociation
&ClientToken=123e4567-e89b-12d3-a456-4266****
&RegionId=cn-hangzhou
&TransitRouterId=tr-6ehx7q2jze8ch5ji0****
&PrefixListId=pl-6ehtn5kqxgeyy08fi****
&TransitRouterTableId=vtb-6ehgc262hr170qgyc****
&NextHop=tr-attach-flbq507rg2ckrj****
&NextHopType=VPC
&DryRun=false
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteTransitRouterPrefixListAssociationResponse>
    <RequestId>835E7F4B-B380-4E0F-96A5-6EA572388047</RequestId>
</DeleteTransitRouterPrefixListAssociationResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "835E7F4B-B380-4E0F-96A5-6EA572388047"
}

Error codes

HttpCode Error code Error message Description
400 NoPermission.AliyunServiceRolePolicyForCEN You are not authorized to create the service linked role. Role Name: AliyunServiceRolePolicyForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission. The error message returned because you are not authorized to create the service-linked role AliyunServiceRolePolicyForCEN for the service cen.aliyuncs.com. You must acquire the ram:CreateServiceLinkedRole permission before you can perform the operation.
400 ResourceNotFound.PrefixlistCidrs Can not find any cidr of specified prefix list. The error message returned because the specified prefix list does not contain a CIDR block. Check the prefix list.
400 ResourceNotFound.Nexthop The specified nexthop instance is not exsit. The error message returned because the specified next hop does not exist. Check the settings.
400 MultipleFound.PrefixlistAssociation multiple same prefix association record found. The error message returned because the configuration records are duplicate.
400 InvalidStatus.PrefixlistAssociation The prefix list association is not in a valid state for the operation. The error message returned because the association is in an invalid state. Try again later.
400 ResourceNotFound.PrefixList The specified prefixlist does not found. The error message returned because the specified prefix list cannot be found. Check whether the prefix list exists.
400 OperationDenied.SystemPrefixList SystemPrefixList can not be operated. The error message returned because no operation can be performed on the specified prefix list.
400 OperationFailed.OperateShareResource Operate share prefixlist failed. The error message returned because no operation can be performed on the specified prefix list.
400 InvalidStatus.Prefixlist Prefixlist is not in a operate status. The error message returned because the specified prefix list is in an invalid state. Try again later.

For a list of error codes, visit the API Error Center.