ec2-replace-route-table-association

Description

Changes the route table associated with a given subnet in a VPC.

You can also use this to change which table is the main route table in the VPC. You just specify the main route table's association ID and the route table that you want to be the new main route table.

After you execute this action, the subnet uses the routes in the new route table it's associated with. For more information about route tables, go to Route Tables in the Amazon Virtual Private Cloud User Guide.

The short version of this command is ec2reprtbassoc.

Syntax

ec2-replace-route-table-association route_table_association_id -r route_table_id

Options

Name Description Required

Name	Description	Required
`route_table_association_id`	The ID for the existing association to replace (which was returned to you when you associated the original route table with subnet). Type: String Default: None Example: rtbassoc-93a045fa	Yes
`-r` `route_table_id`	The ID of the new route table to associate with the subnet. Type: String Default: None Example: -r rtb-6aa34603	Yes

route_table_association_id

The ID for the existing association to replace (which was returned to you when you associated the original route table with subnet).

Type: String

Default: None

Example: rtbassoc-93a045fa

Yes

-r route_table_id

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

Type: String

Default: None

Example: -r rtb-6aa34603

Yes

Common Options

Option	Description
`--region` `REGION`	Overrides the Region specified in the `EC2_URL` environment variable and the URL specified by the `-U` option. Default: The `EC2_URL` environment variable, or `us-east-1` if the environment variable is not set. Example: `--region eu-west-1`
`-U, --url` `URL`	`URL` is the uniform resource locator of the Amazon EC2 web service entry point. Default: The `EC2_URL` environment variable, or https://ec2.amazonaws.com if the environment variable is not set. Example: `-U https://ec2.amazonaws.com`
`-K, --private-key` `EC2-PRIVATE-KEY`	The private key to use when constructing requests to Amazon EC2. Default: The value of the `EC2_PRIVATE_KEY` environment variable. Example: `-K pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem`
`-C, --cert` `EC2-CERT`	The X.509 certificate to use when constructing requests to Amazon EC2. Default: The value of the `EC2_CERT` environment variable. Example: `-C cert-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem`
`--connection-timeout` `TIMEOUT`	Specifies a connection timeout (in seconds). Example: --connection-timeout 30
`--request-timeout` `TIMEOUT`	Specifies a request timeout (in seconds). Example: --request-timeout 45
`-v, --verbose`	Displays verbose output by showing the SOAP request and response on the command line. This is particularly useful if you are building tools to talk directly to our SOAP API.
`-H, --headers`	Displays column headers in the output.
`--show-empty-fields`	Shows empty columns as `(nil)`.
`--hide-tags`	Do not display tags for tagged resources.
`--debug`	Prints internal debugging information. This is useful to assist us when troubleshooting problems.
`-?, --help, -h`	Displays Help.
`-`	If `-` is specified as an argument to one of the parameters, a list of arguments is read from standard input. This is useful for piping the output of one command into the input of another. Example: `ec2-describe-instances \| grep stopped \| cut -f 2 \| ec2-start-instances -`

Output

The command returns a table that contains the following information:

Output type identifier ("ASSOCIATION")
The new association ID
The route table ID

Amazon EC2 command line tools display errors on stderr.

Examples

Example Request

This example starts with a route table associated with a subnet, and a corresponding association ID rtbassoc-f8ad4891. You want to associate a different route table (table rtb-f9ad4890) to the subnet. The result is a new association ID representing the new association.

PROMPT> ec2-replace-route-table-association rtbassoc-f8ad4891 -r rtb-f9ad4890
ASSOCIATION	  rtbassoc-61a34608	rtb-f9ad4890