terraform/website/source/docs/providers/aws/r/route.html.markdown

layout	page_title	sidebar_current	description
aws	AWS: aws_route	docs-aws-resource-route|	Provides a resource to create a routing entry in a VPC routing table.

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

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.