Skip to content

Data Source: aws_route_table#

Provides information about a route table.

This resource can be used when a module accepts a subnet ID as an input variable and needs to, for example, add a route in the route table.

Example Usage#

The following example shows how one might accept a route table ID as a variable and use this data source to obtain the data necessary to create a route.

variable "vpc_id" {}
variable "network_interface_id" {}

data "aws_route_table" "selected" {
  vpc_id = var.vpc_id
}

resource "aws_route" "example" {
  route_table_id         = data.aws_route_table.selected.id
  destination_cidr_block = "10.0.0.0/22"
  network_interface_id   = var.network_interface_id
}

Argument Reference#

The arguments of this data source act as filters for querying the available route table in the current region. The given filters must match exactly one route table whose data will be exported as attributes.

The following arguments are optional:

  • filter - (Optional) One or more name/value pairs to use as filters.
  • subnet_id - (Optional) ID of a subnet which is associated with the route table (not exported if not passed as a parameter).
  • tags - (Optional) Map of tags, each pair of which must exactly match a pair on the desired route table.
  • vpc_id - (Optional) ID of the VPC that the desired route table belongs to.

Attribute Reference#

Supported attributes#

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

  • arn - The Amazon Resource Name (ARN) of the route table.
  • associations - List of associations. The structure of this block is described below.
  • routes - List of routes. The structure of this block is described below.

associations#

Associations are also exported with the following attributes:

  • gateway_id - The ID of the internet gateway.
  • main - Whether the association is due to the main route table.
  • route_table_association_id - The ID of the association.
  • route_table_id - The ID of the route table.
  • subnet_id - The ID of the subnet. Only set when associated with a subnet.

routes#

When relevant, routes are also exported with the following attributes:

For destinations:

  • cidr_block - CIDR block of the route.

For targets:

  • gateway_id - The ID of the internet gateway or virtual private gateway.
  • instance_id - The ID of the instance.
  • network_interface_id - The ID of the network interface.
  • transit_gateway_id - The ID of the transit gateway.

Unsupported attributes#

~> Note These attributes may be present in the terraform.tfstate file, but they have preset values and cannot be specified in configuration files.

The following attributes are not currently supported:

owner_id, routes.carrier_gateway_id, routes.core_network_arn, routes.destination_prefix_list_id, routes.egress_only_gateway_id, routes.ipv6_cidr_block, routes.local_gateway_id, routes.nat_gateway_id, routes.vpc_endpoint_id, routes.vpc_peering_connection_id.