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.
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"] }
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}" }
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.
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. aws_route
provides the following Timeouts configuration options:
create
- (Default 2 minutes
) Used for route creation delete
- (Default 5 minutes
) Used for route deletion
© 2018 HashiCorpLicensed under the MPL 2.0 License.
https://www.terraform.io/docs/providers/aws/r/route.html