aws_route

Provides a resource to create a routing table entry (a route) in a VPC routing table.

NOTE on Route Tables and Routes: Terraform currently provides both a standalone Route resource and a Route Table resource with routes defined in-line. At this time you cannot use a Route Table with in-line routes in conjunction with any Route resources. Doing so will cause a conflict of rule settings and will overwrite rules.

Example usage:

resource "aws_route" "r" {
  route_table_id            = "rtb-4fbb3ac4"
  destination_cidr_block    = "10.0.1.0/22"
  vpc_peering_connection_id = "pcx-45ff3dc1"
  depends_on                = ["aws_route_table.testing"]
}

Example IPv6 Usage:

resource "aws_vpc" "vpc" {
  cidr_block = "10.1.0.0/16"
  assign_generated_ipv6_cidr_block = true
}

resource "aws_egress_only_internet_gateway" "egress" {
  vpc_id = "${aws_vpc.vpc.id}"
}

resource "aws_route" "r" {
  route_table_id               = "rtb-4fbb3ac4"
  destination_ipv6_cidr_block  = "::/0"
  egress_only_gateway_id = "${aws_egress_only_internet_gateway.egress.id}"
}

Argument Reference

The following arguments are supported:

• route_table_id - (Required) The ID of the routing table.
• destination_cidr_block - (Optional) The destination CIDR block.
• destination_ipv6_cidr_block - (Optional) The destination IPv6 CIDR block.
• vpc_peering_connection_id - (Optional) An ID of a VPC peering connection.
• egress_only_gateway_id - (Optional) An ID of a VPC Egress Only Internet Gateway.
• gateway_id - (Optional) An ID of a VPC internet gateway or a virtual private gateway.
• nat_gateway_id - (Optional) An ID of a VPC NAT gateway.
• instance_id - (Optional) An ID of an EC2 instance.
• network_interface_id - (Optional) An ID of a network interface.

Each route must contain either a gateway_id, egress_only_gateway_id a nat_gateway_id, an instance_id or a vpc_peering_connection_id or a network_interface_id. Note that the default route, mapping the VPC's CIDR block to "local", is created implicitly and cannot be specified.

Attributes Reference

In addition to all arguments above, the following attributes are exported:

NOTE: Only the target type that is specified (one of the above) will be exported as an attribute once the resource is created.

• route_table_id - The ID of the routing table.
• destination_cidr_block - The destination CIDR block.
• destination_ipv6_cidr_block - The destination IPv6 CIDR block.
• vpc_peering_connection_id - An ID of a VPC peering connection.
• egress_only_gateway_id - An ID of a VPC Egress Only Internet Gateway.
• gateway_id - An ID of a VPC internet gateway or a virtual private gateway.
• nat_gateway_id - An ID of a VPC NAT gateway.
• instance_id - An ID of a NAT instance.
• network_interface_id - An ID of a network interface.

Timeouts

aws_route provides the following Timeouts configuration options:

• create - (Default 2 minutes) Used for route creation
• delete - (Default 5 minutes) Used for route deletion