Skip to content

EC2  >  Operations  >  replace_route_table_association

replace_route_table_association

Operation

replace_route_table_association async

replace_route_table_association(input: ReplaceRouteTableAssociationInput, plugins: list[Plugin] | None = None) -> ReplaceRouteTableAssociationOutput

Changes the route table associated with a given subnet, internet gateway, or virtual private gateway in a VPC. After the operation completes, the subnet or gateway uses the routes in the new route table. For more information about route tables, see Route tables in the Amazon VPC User Guide.

You can also use this operation to change which table is the main route table in the VPC. Specify the main route table's association ID and the route table ID of the new main route table.

Parameters:

Name Type Description Default
input ReplaceRouteTableAssociationInput

An instance of ReplaceRouteTableAssociationInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
ReplaceRouteTableAssociationOutput

An instance of ReplaceRouteTableAssociationOutput.

Input

ReplaceRouteTableAssociationInput dataclass

Bases: _SerdeShape

Dataclass for ReplaceRouteTableAssociationInput structure.

Attributes

association_id class-attribute instance-attribute
association_id: str | None = ...

The association ID.

dry_run class-attribute instance-attribute
dry_run: bool | None = ...

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

route_table_id class-attribute instance-attribute
route_table_id: str | None = ...

The ID of the new route table to associate with the subnet.

Output

ReplaceRouteTableAssociationOutput dataclass

Bases: _SerdeShape

Dataclass for ReplaceRouteTableAssociationOutput structure.

Attributes

association_state class-attribute instance-attribute
association_state: RouteTableAssociationState | None = ...

The state of the association.

new_association_id class-attribute instance-attribute
new_association_id: str | None = ...

The ID of the new association.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.