Associates a subnet in your VPC or an internet gateway or virtual private gateway attached to your VPC with a route table in your VPC. This association causes traffic from the subnet or gateway to be routed according to the routes in the route table. The action returns an association ID, which you need in order to disassociate the route table later. A route table can be associated with multiple subnets.
For more information, see Route tables in the Amazon VPC User Guide.
Request Parameters
The following parameters are for this specific action. For more information about required and optional parameters that are common to all actions, see Common Query Parameters.
- DryRun
-
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 isUnauthorizedOperation.Type: Boolean
Required: No
- GatewayId
-
The ID of the internet gateway or virtual private gateway.
Type: String
Required: No
- RouteTableId
-
The ID of the route table.
Type: String
Required: Yes
- SubnetId
-
The ID of the subnet.
Type: String
Required: No
Response Elements
The following elements are returned by the service.
- associationId
-
The route table association ID. This ID is required for disassociating the route table.
Type: String
- associationState
-
The state of the association.
Type: RouteTableAssociationState object
- requestId
-
The ID of the request.
Type: String
Errors
For information about the errors that are common to all actions, see Common client error codes.
Examples
Example 1
This example associates a route table with the ID
rtb-11223344556677889 with a subnet with the ID
subnet-12345678901234567.
Sample Request
https://ec2.amazonaws.com/?Action=AssociateRouteTable
&RouteTableId=rtb-11223344556677889
&SubnetId=subnet-12345678901234567Sample Response
<AssociateRouteTableResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
<requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId>
<associationId>rtbassoc-04ca27a6914a0b4f</associationId>
</AssociateRouteTableResponse>Example 2
This example associates a route table with the ID
rtb-11223344556677889 with an internet gateway with the ID
igw-1a2b3c4d1a2b3c4d1.
Sample Request
https://ec2.amazonaws.com/?Action=AssociateRouteTable
&RouteTableId=rtb-11223344556677889
&GatewayId=igw-1a2b3c4d1a2b3c4d1See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
