All Products
Search
Document Center

Virtual Private Cloud:UnassociateRouteTable

Last Updated:Aug 27, 2026

Disassociates a route table from a vSwitch.

Operation description

References

  • UnassociateRouteTable is asynchronous. After a request ID is returned, call DescribeVSwitchAttributes to check the disassociation status:

    • If the vSwitch is in the Pending state, disassociation is in progress.

    • If the vSwitch is in the Available state, disassociation is complete.

  • Do not call UnassociateRouteTable repeatedly on the same vSwitch within a specified period.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

The region ID of the VPC that contains the custom route table.

You can call DescribeRegions to query the most recent region list.

cn-hangzhou

RouteTableId

string

Yes

The ID of the route table.

vtb-bp145q7glnuzdvzu2****

VSwitchId

string

Yes

The ID of the vSwitch to disassociate from the route table.

vsw-25naue4****

ClientToken

string

No

The client token that ensures request idempotency.

The token must be unique across API requests and can contain only ASCII characters.

Note

If you do not set this parameter, the system uses RequestId as the client token. RequestId may differ between API requests.

02fb3da4-130e-11e9-8e44-0016e04115b

RegionId

string

Yes

The region ID of the VPC that contains the custom route table.

You can call DescribeRegions to query the most recent region list.

cn-hangzhou

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

62172DD5-6BAC-45DF-8D44-xxxxxxx

Examples

Success response

JSON format

{
  "RequestId": "62172DD5-6BAC-45DF-8D44-xxxxxxx"
}

Error response

JSON format

{
  "RequestId": "62172DD5-6BAC-45DF-8D44-xxxxxxxx"
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidRegionId.NotFound Specified value of RegionId is not supported.
400 InvalidParameter.Action This vpc feature is not supported in this region
400 IncorrectVSwitchStatus The current status of the virtual switch does not support this operation.
400 OperationUnsupported.SystemRouteTable System route table can not be unassociated. You cannot disassociate the system route table.
400 InvalidStatus.vSwitch Specified vswitch is not in stable status and cannot operate.
404 InvalidRouteTableId.NotFound Specified route table does not exist.
404 InvalidVSwitchId.NotFound Specified vSwitch does not exist.
404 InvalidBindingStatus.RouteTable The specified virtual switch and route table does not bind
404 OperationFailed.VSwitchNotAssociate Specified vswitch is not associated with the routeTable and cannot operate.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.