All Products
Search
Document Center

Virtual Private Cloud:DissociateRouteTableFromGateway

Last Updated:Aug 28, 2026

Disassociates a gateway route table from an IPv4 gateway.

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 IPv4 gateway from which you want to disassociate the gateway route table.

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

ap-southeast-6

RouteTableId

string

Yes

The ID of the gateway route table.

vtb-5ts0ohchwkp3dydt2****

ClientToken

string

No

The client token that ensures the idempotence of the request.

You can use the client to generate the token value, but it must be unique among requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.

Note

If you do not set this parameter, the system automatically uses RequestId as ClientToken. RequestId may be different for each API request.

123e4567-e89b-12d3-a456-426655440000

DryRun

boolean

No

Whether to only precheck the request. Valid values:

  • true: prechecks the request without performing the operation. The system checks the required parameters, request syntax, and limits. If the request fails the precheck, an error message is returned. If the request passes the precheck, the DryRunOperation error code is returned.

  • false (default): sends the request. After the request passes the precheck, a 2xx HTTP status code is returned and the operation is performed.

false

GatewayId

string

Yes

The ID of the IPv4 gateway.

ipv4gw-5tsnc6s4ogsedtp3k****

GatewayType

string

No

The gateway type to disassociate from the route table.

Ipv4Gateway

RegionId

string

Yes

The region ID of the IPv4 gateway from which you want to disassociate the gateway route table.

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

ap-southeast-6

Response elements

Element

Type

Description

Example

object

The response parameters.

RequestId

string

The ID of the request.

C5644C9A-7480-13B6-AECB-30FF142E3724

Error codes

HTTP status code

Error code

Error message

Description

400 OperationFailed.NotExistAssociateRelation The operation is not failed because of not exist this associate relation. The system failed to disassociate the route table from the gateway because the route table is not associated with the gateway.
400 ResourceNotFound.Ipv4Gateway The specified resource ipv4Gateway is not found. The IPv4 gateway is not found and cannot be deleted.
400 IncorrectStatus.Ipv4Gateway The status of %s [%s] is incorrect. The IPv4 gateway is in an invalid state. Try again later.
400 ResourceNotFound.GatewayRouteTable The specified resource GatewayRouteTable is not found. The gateway route table cannot be found.
400 IncorrectStatus.GatewayRouteTable The status of %s [%s] is incorrect. The gateway route table is in an invalid state. Try again later.
400 ResourceNotFound.RouteTable The specified resource gatewayRouteTable is not found. The gateway route table does not exist.
400 OperationDenied.RouteTableTypeIncorrect The operation is not allowed because of %s. The gateway route table is not a border gateway route table.
400 IncorrectStatus.Ipv6Gateway The status of %s [%s] is incorrect. The IPv6 gateway is in an unstable state. Try again later.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.