All Products
Search
Document Center

Virtual Private Cloud:DeleteRouteTable

Last Updated:Aug 28, 2026

Deletes a custom route table.

Operation description

Description

  • DeleteRouteTable is an asynchronous operation. After you send a request, the system returns a request ID and runs the task in the background. You can call DescribeRouteTableList to query the deletion status:

    • If the custom route table is in the Deleting state, deletion is in progress.

    • If the custom route table is no longer returned, deletion is complete.

  • You cannot repeatedly call DeleteRouteTable within the specified period of time.

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 to which the custom route table belongs.

Call DescribeRegions to query available regions.

cn-hangzhou

RouteTableId

string

Yes

The ID of the custom route table to delete.

vtb-bp145q7glnuzdvzu2****

RegionId

string

Yes

The region ID of the VPC to which the custom route table belongs.

Call DescribeRegions to query available regions.

cn-hangzhou

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

DC668356-BCB4-42FD-9BC3-FA2B2E04B634

Examples

Success response

JSON format

{
  "RequestId": "DC668356-BCB4-42FD-9BC3-FA2B2E04B634"
}

Error response

JSON format

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

Error codes

HTTP status code

Error code

Error message

Description

400 OperationDenied.GatewayAssociated You cannot delete the specified route table because it still associates with gateway. The route table is still associated with a gateway.
400 MissingParam.RouteTableId The param of RouteTableId is missing.
400 IncorrectRouteTableType Route table can be deleted by this action only when it's type is custom.
400 IncorrectVSwitchStatus The current virtual switch status does not support this operation. The vSwitch is in the Pending state.
400 IncorrectRouteTableStatus.RouteEntryExist You cannot delete the specified route table because it still has custom route entry. The route table still contains custom route entries.
400 IncorrectStatus.cbnStatus Current CBN status does not support this operation. The status of the CEN instance is invalid.
400 InvalidRegionId.NotFound Specified value of RegionId is not supported.
400 InvalidParameter.Action This vpc feature is not supported in this region
400 IncorrectRouteTableStatus The current status of the route table does not support this operation. You cannot delete the route table in the current state.
400 DependencyViolation.RouteEntry Vpc route table has route entry.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.