route

Gets an individual route resource

Overview

Name	route
Type	Resource
Description	Specifies a route in a route table. For more information, see [Routes](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Route_Tables.html#route-table-routes) in the *Amazon VPC User Guide*.<br/> You must specify either a destination CIDR block or prefix list ID. You must also specify exactly one of the resources as the target.<br/> If you create a route that references a transit gateway in the same template where you create the transit gateway, you must declare a dependency on the transit gateway attachment. The route table cannot use the transit gateway until it has successfully attached to the VPC. Add a [DependsOn Attribute](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-dependson.html) in the ``AWS::EC2::Route`` resource to explicitly declare a dependency on the ``AWS::EC2::TransitGatewayAttachment`` resource.
Id	aws.ec2.route

Fields

Name	Datatype	Description
carrier_gateway_id	string	The ID of the carrier gateway.<br/> You can only use this option when the VPC contains a subnet which is associated with a Wavelength Zone.
cidr_block	string
core_network_arn	string	The Amazon Resource Name (ARN) of the core network.
destination_cidr_block	string	The IPv4 CIDR address block used for the destination match. Routing decisions are based on the most specific match. We modify the specified CIDR block to its canonical form; for example, if you specify ``100.68.0.18/18``, we modify it to ``100.68.0.0/18``.
destination_ipv6_cidr_block	string	The IPv6 CIDR block used for the destination match. Routing decisions are based on the most specific match.
destination_prefix_list_id	string	The ID of a prefix list used for the destination match.
egress_only_internet_gateway_id	string	[IPv6 traffic only] The ID of an egress-only internet gateway.
gateway_id	string	The ID of an internet gateway or virtual private gateway attached to your VPC.
instance_id	string	The ID of a NAT instance in your VPC. The operation fails if you specify an instance ID unless exactly one network interface is attached.
local_gateway_id	string	The ID of the local gateway.
nat_gateway_id	string	[IPv4 traffic only] The ID of a NAT gateway.
network_interface_id	string	The ID of a network interface.
route_table_id	string	The ID of the route table for the route.
transit_gateway_id	string	The ID of a transit gateway.
vpc_endpoint_id	string	The ID of a VPC endpoint. Supported for Gateway Load Balancer endpoints only.
vpc_peering_connection_id	string	The ID of a VPC peering connection.
region	string	AWS region.

Methods

Name	Accessible by	Required Params
update_resource	UPDATE	data__Identifier, data__PatchDocument, region
delete_resource	DELETE	data__Identifier, region
get_resource	SELECT	data__Identifier, region

SELECT Example

SELECT
region,
carrier_gateway_id,
cidr_block,
core_network_arn,
destination_cidr_block,
destination_ipv6_cidr_block,
destination_prefix_list_id,
egress_only_internet_gateway_id,
gateway_id,
instance_id,
local_gateway_id,
nat_gateway_id,
network_interface_id,
route_table_id,
transit_gateway_id,
vpc_endpoint_id,
vpc_peering_connection_id
FROM aws.ec2.route
WHERE data__Identifier = '<RouteTableId>|<CidrBlock>';

Permissions

To operate on the route resource, the following permissions are required:

Read

ec2:DescribeRouteTables

Update

ec2:ReplaceRoute,
ec2:DescribeRouteTables,
ec2:DescribeNetworkInterfaces

Delete

ec2:DeleteRoute,
ec2:DescribeRouteTables