amazonka-ec2-0.3.5: Amazon Elastic Compute Cloud SDK.

Safe HaskellNone
LanguageHaskell2010

Network.AWS.EC2.CreateRoute

Contents

Description

Creates a route in a route table within a VPC.

You must specify one of the following targets: Internet gateway or virtual private gateway, NAT instance, VPC peering connection, or network interface.

When determining how to route traffic, we use the route with the most specific match. For example, let's say the traffic is destined for '192.0.2.3', and the route table includes the following two routes:

'192.0.2.0/24' (goes to some target A)

'192.0.2.0/28' (goes to some target B)

Both routes apply to the traffic destined for '192.0.2.3'. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.

For more information about route tables, see Route Tables in the AmazonVirtual Private Cloud User Guide.

http://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-CreateRoute.html

Synopsis

Request

Request constructor

Request lenses

crClientToken :: Lens' CreateRoute (Maybe Text) Source

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

crDestinationCidrBlock :: Lens' CreateRoute Text Source

The CIDR address block used for the destination match. Routing decisions are based on the most specific match.

crDryRun :: Lens' CreateRoute (Maybe Bool) Source

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

crGatewayId :: Lens' CreateRoute (Maybe Text) Source

The ID of an Internet gateway or virtual private gateway attached to your VPC.

crInstanceId :: Lens' CreateRoute (Maybe Text) Source

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.

crNetworkInterfaceId :: Lens' CreateRoute (Maybe Text) Source

The ID of a network interface.

crRouteTableId :: Lens' CreateRoute Text Source

The ID of the route table for the route.

crVpcPeeringConnectionId :: Lens' CreateRoute (Maybe Text) Source

The ID of a VPC peering connection.

Response

Response constructor

createRouteResponse :: CreateRouteResponse Source

CreateRouteResponse constructor.

The fields accessible through corresponding lenses are:

Response lenses

crrClientToken :: Lens' CreateRouteResponse (Maybe Text) Source

Unique, case-sensitive identifier you provide to ensure the idempotency of the request.

crrReturn :: Lens' CreateRouteResponse (Maybe Bool) Source

Returns true if the request succeeds; otherwise, it returns an error.